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Рупоп. Полное руководство 


ВВЕДЕНИЕ 


Вкратце о Ру{Поп 


РуФоп -— одновременно мощный и простой язык программирования, раз- 
работанный Гвидо ванн Россумом (Сли@о уап Воззита) в 1991 году. С одной 
стороны, язык довольно молодой (тот же С был разработан в 1972 году), с 
другой стороны, ему уже 30 лет и за это время его успели довести до того 
уровня, когда на нем можно написать проект любого масштаба, в том числе 
коммерческие приложения, работающие с очень важными данными. 


Руоп - это высокоуровневый язык программирования общего назна- 
чения, ориентированный на повышение производительности разработчика 
и читаемости кода. Другими словами, писать программы на Ру{оп доволь- 
но просто, а код самих программ будет гораздо лучше восприниматься, чем 
в случае с другими языками программирования. 


Синтаксис ядра этого языка программирования минималистичен, однако, 
стандартная библиотека содержит множество полезных функций. 


Тех вольностей, которые себе программист мог позволить в других языках 
программирования, например, в Разса|, С, ]ауа или РНР здесь непозволи- 
тельны. Один лишний или недостающий отступ - и вы получите синтакси- 
ческую ошибку. Так Руфоп приучает программиста писать красивый и чи- 
табельный код. С одной стороны, если я бы не советовал выбирать Руфоп 
в качестве первого языка программирования - вам будет сложно. С другой 


стороны, это как учиться ездить на автомобиле зимой в гололед. После та- 
кой школы летом вы уж точно будете ездить — с легкостью сможете освоить 
другие языки программирования. 


РуШоп поддерживает несколько парадигм программирования, в том числе 
структурное, объектно-ориентированное, функциональное, императивное 
и аспектно-ориентированное. Это означает, что вы можете выбрать любой 
стиль программирования. Новичкам, создающим относительно несложные 
программы, подойдет функциональный стиль. А для серьезных проектов, 
как правило, выбирают объектно-ориентированное и/или аспектно-ори- 
ентированное программирование. 


Кросс-платформенность 


Ру оп портирован и работает почти на всех известных платформах - от 
карманных компьютеров и смартфонов до мейнфреймов. Существуют вер- 
сии Руоп под М!сгозой УЛп4о\, практически все варианты МХ (вклю- 
чая ЕгееВ$О и Ппах), Р!ап 9, тасО$ и тасО$ Х, 1Рвопе О$ 2.0 и выше, 
Ра|п О$, О$/2, Апира, НакиО$, А$/400 и даже О$/390, УЛп4о\миз Мое, 
ЗутЫап и Апаго!4. 


Важно понимать, что программы, написанные на РуШФоп, независимы от 
платформы. Другими словами, вы можете написать программу, которая бу- 
дет работать и на вашем тасО$ Х и на УЛп4до\з-компьютере приятеля и 
даже на 1РБопе. Главное, чтобы на устройстве, на котором планируется за- 
пускать программу, был установлен Руфоп. 


Ру Поп — один из самых простых 
языков программирования 


Когда-то давно программы писались с помощью переключения различных 
разъемов на компьютерах, которые занимали целые залы. Затем появились 
перфокарты - специальные карточки, используемые для ввода программы, 
после - язык программирования Ассемблер, позволяющий манипулиро- 
вать данными прямо в регистрах процессора. Это пример низкоуровнего 
языка. Даже самая простая программа на этом языке представляла доволь- 
но большой, сложный и непонятный непосвященному человеку кусок кода. 


С появлением высокоуровневых языков, таких как С, ]ауа все изменилось. 
Такие языки программирования ближе к человеческому языку, чем к ма- 
шинному. РуФоп делает синтаксис еще проще. Его правила приближают- 
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ся к английскому языку. Создание программ на Ру оп настолько простой 
процесс, что о нем говорят как о "программировании со скоростью мысли". 
Все это позволяет повысить производительность труда программиста — про- 
граммы на Руроп требуют меньше времени на разработку, чем программы 
на других языках программирования. 


Популярность Ру{Поп 


Если вы раньше ничего не слышали о Руроп и думаете, что он непопулярен, 
то вы ошибаетесь. Его используют разработчики со всего мира, ним поль- 
зуются крупнейшие корпорации, такие как Соое, МАЗА, Ве4 На, УаБоо!, 
Хегох, [ВМ, М!сгозой и др. Так, Соое предпочитает С++, ]ауа и Руоп!, а 
М!сгозой даже открыла Ру оп Оеуе]орег Сегцег?. 


Популярные программные продукты УаКоо, в том числе О}апро3, ТагоСе- 
агз‘ и Горе’ написаны на Руогп. 


Некоторым начинающим программистам, которые только выбирают язык 
программирования, программы: на Руфоп могут показаться неказистыми. 
Порой кажется, что ничего серьезного на этом языке не разработаешь, и он 
больше приближен к сценариям оболочки, чем к полноценным языкам 
программирования, таким как С#. 


Это заблуждение. Многие популярные игры от ЕА Сатез, 2К Сатез и 
015пеу Пцегасйуе, написаны на Руоп: 


#грз/ /ватеаеояасйехсвапре.сот/диезНоп$/5035/атоиз-ватез-шпиеп-т- 
рудоп 


Игра - это одно из самых сложных приложений, поскольку оно сочетает 
работу с графикой, музыкой, сложную логику ит.д. 


Сколько это стоит? 


Интерпретатор Руфоп абсолютно бесплатен и распространяется свободно. 
Чтобы использовать его, вам не нужно ничего платить, но зато вы можете 
абсолютно свободно продавать свои программы, написанные на Ру оп — 
это позволяет лицензия, по которой распространяется этот интерпретатор. 


Верз://ммзапога.сот/\Лмсв-ргоргатитипя-1аппазез-4оез-Соов]е-изе-пцегпаПЙу 
В брз: //агиге.тисгозой.сот/еп-и5/4еу@ор/руВоп/ 


В рэ: //епмиИаре1а.оге/м И /О}апво_(\меБ_#ате\иогК) 
В брз: //еп мере 1а.оге/\/ КИ ТигфоСеаг$ 
В рэ: / /ги мире а.отв/\КИ/оре 


лье № - 


Такие условия лицензии способствуют популярности этого языка програм- 
мирования. Ведь для старта вам не нужно ничего и никому платить. Вы мо- 
жете использовать Ру!фогп, как для обучения программированию, так и для 
создания коммерческих программ. В отличие от других языков программи- 
рования, где за использование среды программирования нужно выложить 
кругленькую сумму, например, за У1зиа| Зи 10 придется выложить более 
500 евро, а стоимость некоторых сторонних компонентов превышает 1500 
евро (например, ПеуЕхргез$). 


Понятно, что это останавливает многих программистов-одиночек или 
заставляет их использовать пиратские версии. А на Ру поп вы можете 
программировать с чистой совестью -— все изначально доступно бесплатно. 


Философия РуПоп 


Чтобы введение не было однотипным и скучным, расскажу вам о филосо- 
фии РуШфоп. РуШФогп - это не простой язык программирования, у него есть 
своя философия, разработанная Тимом Петерсом. 


Философия выводится один раз за сессию при вводе команды 


1трокЕ {61$ 


Результат выполнения этой команды изображен на рис. В.1. 


2% Рипоп 3.6.5 $пей — О х | 


Ее Едй Зе! Ребуд ОрНоп5 У/йпдом Нер | 
РУЕПоп 3.6.5 (\3.6.5:Е59с0932Ь4, Маг 28 2018, 16:07:46} [М№М5С у.1900 32 Ь1Е ({ттие ^ 
1)] оп м11п32 

Туре "соруг1аре", "сге91%5" ог "11сепзе{}" Ёог моге 1пЁогта&1оп. 

>>> Нирохф 115 

Тре 2еп оЁ РуЕрВоп, Бу Т1т Ресег5 


Веаие1 11 15 Бесфег Пап и91у. 

Ехр11с1е 15$ Бебеег Пап 1тр11с1е. 

31тр1е 15 Бесфег {Вап сотр1ех. 

Сотр1ех 15 Беееег ЕВап сопр11саееч. 

Е1аЕ 15$ Бесфег ЕРап пез%еЧ. 

брагзе 15 Бесфег ЕВап 4епзе. 

ВеаЧаЪ111Еу сойпе5. 

5рес1а1 сазез агеп'Е зрес1а1 епойпдВ +0 Бгеак %Пе ги1ез. 
А1ЕВопдВ ргасЕ1са11Еу Беае5$ риг1у. 

Еггог$ 5Роц14 пеуег ра55 $11еп1у. 

0п1е55 ехр11с1Е1у $11епсед. 

Тп {Ве Еасе оЁ апЬ19а16еу, геЁРазе &пе сетреаЕ1оп ®©о дие5$. 
Треге 5Вой14 Бе опе-- ап4 ргеёегаю1у оп1у опе --оБу1о15 мау о 4о 1%. 
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Рис. В.1. Философия Рутоп 


Руоп. Полное руководство Мммм {2 ручпоп 


Вот текст философии в переводе с английского языка: 


Красивое лучше, чем уродливое. 

Явное лучше, чем неявное. 

Простое лучше, чем сложное. 

Сложное лучше, чем запутанное. 

Плоское лучше, чем вложенное. 

Разреженное лучше, чем плотное. 

Читаемость имеет значение. 

Особые случаи не настолько особые, чтобы нарушать правила. 
При этом практичность важнее безупречности. 

Ошибки никогда не должны замалчиваться. 

Если не замалчиваются явно. 
Встретив двусмысленность, отбрось искушение угадать. 
Должен существовать один - и, желательно, только один — 
очевидный способ сделать это. 

Хотя он поначалу может быть и не очевиден, если вы не 
голландец. 

Сейчас лучше, чем никогда. 

Хотя никогда зачастую лучше, чем прямо сейчас. 


Если реализацию сложно объяснить — идея плоха. 
Если реализацию легко объяснить — идея, возможно, хороша. 
Пространства имён — отличная штука! Будем делать их побольше! 


Приятного чтения! 


ГЛАВА 1. 
ОСНОВЫ. ПЕРВАЯ 


ПРОГРАММА 


РУНоп. Полное руководсто ВВ @, ру+поп 


1.1. О версии Ру{Поп 


На момент написания этих строк текущей является версия 3.9.2. Однако 
параллельно с веткой 3.х доступна и ветка 2.7 (хотя ее поддержка завершена 
в прошлом, 2020-ом, году). Какую версию выбрать - 3.х или 2.7? 


В Интернете вы можете часто найти рекомендации бывалых программи- 
стов, рекомендующих использовать версии 2.7. Они мотивируют это нали- 
чием огромного количества кода, написанного под версию 2.7, своим опы- 
том разработки в версии 2.7 и, конечно же, нежеланием переходить на ветку 
3.0 (тогда придется переписать много кода). 


Однако посмотрите на дату, когда были написаны эти рекомендации. Ско- 
рее всего, это будет 2009 или 2012 год максимум. Первая версия РуШФоп 3.0 
появилась в декабре 2008 года, с тех пор уже много воды утекло, и большая 
часть их рекомендаций уже потеряла свою актуальность. 


Если вы - начинающий программист и только хотите начать осваивать 
РуШоп, вам следует выбрать самую новую версию - 3.9. 


Совсем другое дело, когда вы — уже состоявшийся программист, знаете дру- 
гие языки программирования (например, С++, РНР) и вам необходимо 
изучить Руоп, поскольку вам предложили место в компании, которая ве- 
дет разработку на этом языке программирования, тогда все зависит от ком- 
пании. 


2; рутпоп их ыы Глава 1. Основы. Первая программа 


Если компания использует версию 2.7, тогда выбора у вас нет - его за вас 
сделала компания, а переписывать весь код на 3.х — нет времени. Подробно 
о разнице между версиями 2.7 и 3.0 рассказано здесь: 


#1р5:/ /ируфоп.отр/тот/Руфоп2отРу#опт3 6 


Во всех остальных случаях нет смысла говорить о ветке 2.7, так как ее под- 
держка завершена и больше нет смысла ее использовать. 


1.2. Установка Ру{Поп 3 


Как вы уже догадались, далее будет рассматриваться только ветка 3.х как 
самая актуальная на данный момент. Скачать инсталлятор Ру оп можно 
по адресу: 


#5: //юшшрушоп.оте/4оштоа4$/ 


Обратите внимание, что Ру{оп - это кросс-платформенный язык, и есть 
его версии для Глпих и МасО$. Далее все иллюстрации будут соответство- 
вать УЛп4о\з 10, поскольку эта ОС используется большинством пользова- 
телей в данный момент. 
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Асйуе РуНоп Вей 


нм сеаоьа аа об щррове Ферт вета 
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рубот 34-2 тиф. 9. 2024 & соо ыы й 


Рупоп. Полное рукводстто 9 ©; руспоп 


Скачайте и запустите инсталлятор (файл руФоп-3.9.2ат 9 64.ехе). Первым 
делом нужно выбрать определиться, что вы хотите сделать — или устано- 
вить с установками по умолчанию (кнопка Та$6а] М№о\) или кастомизиро- 
вать инсталляцию. Стандартные установки использовать не рекомендуется 
хотя бы по той причине, что РуКоп 3.9.2 устанавливается в домашний ката- 
лог пользователя, а обычно нужно сократить путь к интерпретатору, поэто- 
му лучше выбрать Сизбкопие ш$аПаНоп, а перед этим включить флажок 
АДА РуШоп 3.9 фо РАТН, чтобы инсталлятор сам добавил путь к интерпре- 
татору в переменную РАТН. 
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Рис. 1.2. Тип установки 


Далее нужно выбрать, какие компоненты Руоп нужно установить (рис. 
1.3). Как правило, здесь нужно просто нажать кнопку №ехё. 
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Рис. 1.3. Выбор компонентов Рупоп Ф 
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Затем нужно выбрать каталог для установки (рис. 1.4). Как уже было отме- 
чено, по умолчанию Ру{оп устанавливается в домашний каталог пользова- 
теля, вызвавшего установку, но лучше установить его в корневой каталог 
(например, в С\РуФоп) — там вам будет удобнее работать с интерпретато- 
ром. 
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Рис. 1.4. Выбор каталога для установки 


При выборе каталога для установки есть возможность выбрать различные 
опции вроде ассоциации файлов .ру с Руфоп, добавления Руоп в пере- 
менные окружения и т.д. Установите опции по своему усмотрению. 


После нажатия кнопки ТазваЙ начнется процесс установки Ру{Воп и нуж- 
но будет немного подождать. По окончанию этого процесса нужно нажать 
кнопку С]оз$е (рис. 1.5). 
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Рис. 1.5. Рупоп 3.9.2 установлен 


Руоп. Полное руководсто = 99мм #2 ручпоп 


Поздравляю! Вы только что установили Руоп и можете приступить к его 
изучению. 


Технические подробности. При установке инсталлятор связыва- 
ет расширение .ру с программой ру{Поп.ехе, а расширение ‚рум 
с программой рупоп\.ехе. Первая программа используется для 
выполнения консольных приложений, а вторая — оконных. 


В Ппих в большинстве случаев Ру оп уже будет установлен. Если это не 
так, то с помощью команды зиао арЕ 1п36а11 руЕВоп (команда уста- 
новки, как и название самого устанавливаемого пакета, может отличаться в 
зависимости от используемого дистрибутива) это можно легко исправить. 


1.3. Первая программа на Ру{Поп 


Для запуска вашей первой программы вы можете запустить или программу 
ру оп.ехе (она находится в каталоге, в который вы установили Руфоп') 
или запустить среду разработки ГОГ (это можно сделать с помощью меню 
Пуск) — см. рис. 1.7. 


| — Если вы добавили Руфоп в РАТН, то можно просто ввести команду ру оп 


Рис. 1.6. Программа рутоп.ехе 
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Рис. 1.7. Оболочка ГОЕЕ 


Начинающих программистов вид командной строки наверняка отпугнет, 
поэтому лучше выбрать ГШОТЕ. 


Код вашей первой программы представлен в листинге 1.1. Не нужно быть 
великим программистом, чтобы догадаться, что делает эта программа. Во 
многих учебниках по программированию первая программа обязательно 
должна выводить строчку Нео, мог! Мы не стали отступать от традиции 
и решили написать такую же программу. 


Листинг 1.1. Первая программа 


# Сопмеп® 
рклпе ("Не11о, мог1а!") 


Как вводить программу? Вводите программу строчка за строчкой, а по 
окончанию ввода строки нажимайте Епёег. Поскольку РуФоп - это интер- 
претатор, то результат выполнения строки кода вы увидите мгновенно. В 
результате обработки комментария Ру(оп, как и следовало бы ожидать, 


Ру!Поп. Полное руководство О в. ру%«Поп 


ничего не выведет. А вот в результате обработки второй строчки кода будет 
выведен текст Нео, мой! Результат выполнения сценария изображен на 


рис. 1.8. 
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Рис. 1.8. Результат выполнения сценария. Первая программа 


1.4. Подробно о ПОЕЕ 


1.4.1. ПОДСКАЗКИ ПРИ ВВОДЕ КОДА 


Несмотря на кажущуюся простоту ГОГЕ оснащена функцией подсказки 


при вводе кода - как у "полноценных" сред программирования (рис. 1.9). 
Введите название функции или метода, и вы получите подсказку по пара- 
метрам, которые нужно передать этой функции или методу. 


РУО 3.9. 
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Рис. 1.9. Подсказка при вводе кода Ф 
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Введите рип ("Нео") и нажмите Ещег. Вы только что написали свою пер- 
вую программу и получили результат ее выполнения - строчку "Нео". 


Функция рг!п() выводит на консоль текст, помещенный вовнутрь скобок 
и заключенный в кавычки. Если в скобках ничего нет, то будет выведена 
пустая строка. 


Внимание! Ру{Поп чувствителен к регистру символов. Все назва- 
ния функций пишутся строчными буквами, поэтому рйп(() — это 
правильно, а Рип() или РЕМТ() - нет. 


1.4.2. ПОДСВЕТКА СИНТАКСИСА 


Среда ГОГ, как и ее старшие собратья, обеспечивает подсветку синтакси- 


са. Это означает, что слова на экране отображаются разными цветами. Такое 
явление упрощает понимание того, что именно вы вводите. Каждое слово 
по определенному правилу окрашивается в определенный цвет. 


Так, имена функций окрашиваются в фиолетовый цвет, строковые значе- 
ния - в зеленый. Если ГОГЕ не может распознать, что именно вы ввели, то 
это слово никак не окрашивается. При светлой теме оформления оно будет 
напечатано черным, при темной - белым. 


Результат работы программы интерпретатор выводит на экран шрифтом 
голубого цвета - так вы можете отделить код от его результата визуально. 


Если вы проделали пример с функциями рип) и Рг!п{(), то заметили, что 
первая функция была окрашена в фиолетовый, а вторая - никак не окраше- 
на. Подсветка синтаксиса позволяет помочь понять, что вы что-то делаете 
не так и исправить ошибку еще до запуска кода. На первых порах подсветка 
синтаксиса станет вашим незаменимым помощником, ведь она делает код 
понятным с первого взгляда и позволяет сразу увидеть ошибки, если тако- 
вые имеются. 


1.4.3. ИЗМЕНЕНИЕ ЦВЕТОВОЙ ТЕМЫ 


Среда ТОГЕ позволяет изменять цвет оформления элементов. Выбрать 
цветовую тему можно в настройках: Орйоп$, Сопйгиге ГОГ. Далее нужно 
перейти на вкладку НизЪИвипя и выбрать тему оформления. На рис. 1.10 
показано, что выбрана тема ТОГЕ ПагК. 


При желании, вы можете создать собственную подсветку. Для ЭТОГО ВЫ- 
берите элемент, для которого вы хотите изменить цвет, а затем нажмите 
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Рис. 1.10. Выбор темы оформления 


кнопку Своо$е Со]оиг фог. Также можно воспользоваться переключателями 
Еогергоип4 (цвет шрифта) и ВасКргоип4 (цвет фона). 


Как только результат вам понравится, нажмите кнопку Зауе аз Ме’ Сизбот 
ТЬете. Затем включите в группе НБ ипя ТБеше переключатель а 
Сизбот ТВеште и выберите свою тему оформления. 


На вкладке Еопё$/ТаБ можно установить другие параметры шрифта — 
выбрать другую гарнитуру, установить другой размер. По умолчанию ис- 
пользуется шрифт Соипег №е\ размером 10 пунктов. 
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Рис. 1.11. Изменение цветовой темы 
1.4.4. ГОРЯЧИЕ КЛАВИШИ 


Среда ГОГЕ поддерживает горячие клавиши, приведенные в таблице 1.1. 


Таблица 1.1. Некоторые горячие клавиши 


Рупоп. Полное руководстто 99 #2 рутпоп 


Сы + О 


Закрыть все окна 


А] + Е4 


Закрыть окно (выход) 


Сы + С, Сы] + Х, СЫ + У 


Стандартные клавиши управления бу- 
фером обмена 


СЫ] + ВасКзрасе 


Удалить слово слева 


С + Раее 


Удалить слово справа 


Си +Е Поиск 
АЕ + ЕЗ Поиск в файлах 
СЕ + ЕЗ Найти в выделенном 
С1+ С Найти снова 
АЁ +4 Форматировать параграф 
А +5 Перейти к строке 
С1+С Прервать выполнение (когда оно за- 
пущено) 
АЁ+щт Открыть модуль 
Си +М Открыть новое окно 
С +0 Открыть окно с файлом 
СЫ1+Р Распечатать окно 
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С1+ 7 Отменить последнее действие 


2. ру*Воп 


С1+Н Замена в тексте 


Запустить модуль на выполнение 


СЫ] + Еб Перезапустить оболочку 


АЕ + $Ы& + $ Сохранить копию окна как файл 


Сы1 + 5ЫЙ + $ Сохранить окно как файл 
Выделить все 
Сделать отступ 


Просмотреть перезапуск 


Внимание! Комбинации клавиш не работают? Обратите внима- 
ние на язык ввода. Он должен быть английским. Если вы нажи- 
маете Си“! + \, а язык ввода — болгарский, то Руоп видит ком- 
бинацию клавиш СЁ + М и поэтому она не срабатывает! Подход 
не очень правильный, но какой есть. Именно поэтому я пред- 
почитаю использовать сторонний редактор для редактирования 
Руоп-программ, ане редактор среды 10ЕЕ. В последний можно 
загрузить уже готовую программу, например, для ее отладки. 
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1.5. Помещение программы в 
отдельный файл. Кодировка текста 


Режим интерпретатора хорош, когда вы только учитесь программирова- 


ния и то — для совсем небольших программ. Когда программа содержит не- 
сколько десятков строк кода, лучше поместить ее в отдельный файл с рас- 
ширением .ру. 


Кодировка программ, написанных на Руфоп — ОТЕ-8, поэтому для редак- 
тирования таких -файлов подходит не каждый редактор. Если вы ище- 
те редактор попроще, то можно использовать программу Мо{ераа2 (рир:// 
иииЛоз-Ггеешате.сй/). Это базовый редактор, но он поддерживает подсвет- 
ку синтаксиса РуФоп и кодировку ОТЕ-8. Минимальный набор. Если же 
вам нужны такие "плюшки", как автодополнение кода, поддержка системы 
контроля версий СЕ, можно использовать редакторы вроде Ающ или М!- 
сгозой \Узиа| Зи ю Соде. Такие редакторы подойдут для даже сложных 
проектов, состоящих из множества Руфоп-файлов. 


Создайте файл с расширением ‚ру. Пусть это будет файл Е\Руоп\ 
затр!ез\1.ру. Выберите кодировку файла в редакторе Аёот. Поместите в 
него всего одну строчку кода: 


рхапЕ ("Не11о") 


Сохраните файл. Теперь разберемся, как его запустить. Самый простой спо- 
соб — открыть командую строку и ввести команду: 


руЕВоп Е: \Руброп\запр1ез\1.ру 


Примечание. Вам интересно, как я изменил заголовок команд- 
ной строки в \\Мпаом$? Для этого используется команда е 
<ваша_строка>. Для дополнительной информации обратитесь к 
руководству по командам ста.ехе. 


Если вы предпочитаете использовать ШОГЕ, выберите команду меню Ее, 
Ореп. Выберите ранее сохраненный файл 1.ру. Он откроется в отдельном 
окне. В этом окне нужно выбрать команду меню Вип, Кип Модше или 
просто нажать Е5. 


Если запускаемый сценарий писали не вы и его кодировка отличается от 
ОТЕ-8, ее можно указать так: 
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# - *- соа1па: ср1251 -*- 


Вместо ср1251 нужно указать вашу кодировку. Однако можно использовать 
редактор М№оера42, чтобы просто перекодировать файл в ОТЕ-8. Для этого 
нужно выполнить команду меню ЕЙе, Епсодшя, Весоде и в появившемся 
окне выбрать нужную кодировку и нажать ОК. 


1.6. Структура программы 


Структура Руоп-программы довольно проста, но, тем не менее, она отли- 
чается от структуры программ, используемой в других языках программи- 
рования. Если вы ранее программировали на С/С++, РНР или ]ауа, вам 
поначалу будет немного непривычно. 


Если вы программируете в Глпих, то первой строкой должна быть строка, 
указывающая путь к интерпретатору Руоп: 


#!/озк/р1п/руЕПоп 


Обратите внимание: пробелов быть не должно. Ни до решетки (#), ни после 
нее, ни после восклицательного знака. Узнать путь к Ру!Фоп в вашей систе- 
ме можно с помощью команды \Ы СВ: 


$ ирфсН руЕВоп 
/пзк/Б1п/руЕНоп 


Если вы указали путь к интерпретатору, то вы можете превратить свою 
программу в полноценный сценарий и запускать ее без указания руйоп в 
командной строке. Сейчас поясню. Пусть у вас есть сценарий Ягзё.ру. В нем 
в качестве первой строки указан путь к РуВоп. Вам нужно его сделать ис- 
полнимым: 


$ спюоЯ +х Нгзе.ру 


После этого вы можете запустить его так: 


$ ./Незе.ру 


Строка с указанием пути к интерпретатору - это не инструкция Руогп, а 
инструкция командного интерпретатора БазВ, который, благодаря ней, бу- 
дет знать, какая программа будет обрабатывать сценарий. Если вы не ука- 
жите эту первую строку, БазВ посчитает сценарий Йгз{.ру собственным сце- 
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нарием, а поскольку синтаксис БазВ ни разу не похож на синтаксис Руфоп, 
возникнет ошибка. 


Если вы не хотите превращать свои программы в отдельные сценарии, вы 
можете запускать их, как в УЛп4о\з: 


$ руЕПоп <имя_ программы.ру> 


Вторая строка программы (или первая, если вы программируетев УЛп4о\з) 
— это строка с указанием кодировки: 


# -*- соа109: иЕЕ-8 -*1троге 
По умолчанию используется кодировка ОТЕ-8, и эту строку можно было 


бы не указать, но ее наличие в ваших программах свидетельствует о хоро- 
шем тоне. Если кодировка файла отличается от ОТЕ-8, данная строка (с 
указанием конкретной кодировки) обязательна! 


После этих двух служебных строк начинается код самой программы. При- 
мечательная особенность Ру{Фоп заключается в том, что каждая инструк- 
ция располагается на отдельной строке и при этом, если она не является 
вложенной, то должна начинаться с самого начала строки. Рассмотрим 
пример, продемонстрированный на рис. 1.12 Простейшая программа — ис 
ошибкой. Как видите, инструкция начинается с пробела, а не с начала стро- 
ки, поэтому вы получили ошибку 


ЗупбахЕкхког: ипехресфеЯ 1паепе 


$ Ю4Е $пей 3.9.2 
Не Еди блей Оебиа Орбопз Мёпаом Нер 


РуЕпоп 3.9.2 (5а95/93.3.2:1а79785, РеБ 19 2021, 13:44:55} {43С ч.1926 64 Б1Е (АМ ^ 
064}} оп 1132 


хзанс”, "сгеа{&з”" ог “З3сепзе(}" Еог шоге 1пРогаефоп. 
чая!) 


>>> ВреттЕ(" 


>>> | 


Рис. 1.12. Ошибка: неожиданный отступ 
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Хорошо, что интерпретатор подсказывает, что не так, и даже показывает по- 
зицию ошибки. 


Во многих языках программирования (РНР С, Раса], Рет|, ]ауа и др.) каж- 
дая инструкция должна завершаться точкой с запятой. В Руоп точка с за- 
пятой необязательна. Но и ее наличие не вызовет ошибку, если вы вдруг 
поставили ее по привычке. Поэтому следующие два варианта инструкции 
— правильные с точки зрения синтаксиса: 


релпЕ ("Ну !") 
релпе ("Н1!"); 


Концом инструкции в РуВоп считается конец строки (символ ЕОТ.). Одна- 


ко точка с запятой обязательна, если вы хотите поместить в одну строку 
несколько инструкций, например: 

ао БЕ СЕ хзазь с: 

>>> ргапЕ(х) 

14 


Также в других языках программирования мы привыкли видеть фигурные 
скобки, которые разграничивают инструкции внутри блока. Например, вот 
код на РНР: 


$х = 0; 

мр11е ($х < 5) { 
есво "$х \п"; 
$х++; 

} 


еспо "Все"; 


А вот аналогичный код на Руоп: 


х=0 

мВ11ех < 5: 
рг1 пе (х) 
х += 1 


рг1пЕ ("Все") 
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Перед всеми инструкциями блока должно быть расположено одинаковое 
количество пробелов. Так Ру{оп распознает, какая инструкция и к какому 
блоку относится. При написании кода в ШГЕ одинаковое количество про- 
белов проставляется автоматически, а для завершения блока при переходе 
на следующую строку вы должны нажать ВасКзрасе, а затем — Ещег. При 
написании кода в редакторе количество пробелов нужно учитывать само- 
стоятельно. Обычно используется 4 пробела. Если количество пробелов 
внутри блока - разное, Ру{Воп выведет фатальную ошибку и выполнение 
программы будет остановлено. Сначала вам будет непривычно, но спустя 
месяц программирования на РуФоп вы научитесь писать понятный и кра- 
сивый код. Ведь в других языках программирования вы можете написать 
хоть все инструкции программы, в том числе вложенные, в одну строку. 
Главное, чтобы было правильно с точки зрения синтаксиса. В результате 
читать такую "кашу" из кода не очень удобно. В Руоп такого быть не мо- 
жет — хочешь не хочешь, а придется создавать понятный код. 


Если весь ваш блок состоит всего из одной инструкции, разрешается раз- 
местить ее на одной строке с основной инструкцией, например: 


Гог х 1п гапде (1 , 10): ргапЕ (к) 


Если инструкция слишком длинная, то вы можете разбить ее или символом 
перевода строки (\) или поместив ее в круглые скобки. Во втором случае 
внутри инструкции вы сможете использовать даже комментарии. Примеры: 


х=атч+Ь \ 
© 


х = (а+ьЬ # Сопмеп® 

©) 
В первом случае никакие другие символы не разрешаются, в том числе и 
комментарии. 


1.7. Комментарии 


Как вы уже успели понять, комментарии в Руоп начинаются с решетки. 
Комментарий может начинаться, как с новой строки, так и помещен после 
инструкции: 
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рг1п* ("Привет") # Это тоже комментарий 


# Это комментарий 


Если решетка размещена перед инструкцией, то инструкция считается ком- 
ментарием и не будет выполнена: 


# рг1пе ("Привет") 


Также # не считается символом комментария, если он находится внутри ка- 
вычек или апострофов, например: 


рг1п* ("# Комментарий") 


В Руфоп нет многострочного комментария, поэтому можете или использо- 
вать несколько комментариев: 


# Многострочный 
$ комментарий 


Можно также использовать тройные кавычки: 


Многострочный 
комментарий 


ии" 


Данная конструкция не игнорируется интерпретатором. Он создает строко- 
вой объект, но так как все инструкции внутри тройных кавычек считаются 
текстом, никакие действия производиться не будут. 


Однако знайте, что при частом использовании такого подхода в большой 
программе будет наблюдаться нерациональное использование памяти, по- 
скольку обычные комментарии игнорируются, а в случае с тройными ка- 
вычками создается строковой объект. 


С одной стороны, объемом оперативной памяти в 16 Гб сегодня никого не 
удивишь, и те несколько килобайтов перерасхода памяти в очень большой 
программе особой роли не сыграют. С другой стороны, нужно привыкать к 
рациональному использованию ресурсов компьютера. Сегодня вы исполь- 
зовали тройные кавычки, чтобы закомментировать несколько килобайтов 
текста, завтра — забудете закрыть соединение или освободить память. Ин- 
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терпретатор Ру оп по окончанию работы сценария автоматически закры- 
вает все выделенные программе ресурсы (в том числе файлы и соединения), 
но такой подход считается очень плохим тоном среди программистов. 


'Тройные кавычки удобно использовать, чтобы временно закомментировать 
какой-то участок кода (чтобы не дописывать в начале каждой строки #, а 
потом не удалять ее, когда вам вновь понадобится этот фрагмент кода). 


Использовать или нет тройные кавычки — решать вам. Я вам показал, как 
их можно использовать и рассказал о преимуществах и недостатках этого 
способа. 


1.8. Ввод/вывод данных 


В этом разделе мы поговорим о вводе и выводе данных. Ранее было пока- 
зано, что для вывода данных используется инструкция (функция) реп. 
Полный синтаксис рип () выглядит так: 

рг1пЕе ( [<Объекты>][, зер=' '][,епд='\п'] [, Н1е=зуз.зЕ4оп*]) 
Разберемся с параметрами функции. Первый параметр - это набор объек- 
тов, которые нужно вывести. Список объектов разделяется запятыми. На- 


пример: 


>>> а=1; Б=а2; 
>>> ргелпЕ (а, Ь) 
12 


Как видите, между объектами автоматически вставляется разделитель — по 
умолчанию Пробел. Задать собственный разделитель можно с помощью па- 
раметра $ер. Например, вы можете задать символ табуляции: 


>>> ргапЕ (а, Ь, зер='\') 
1. 2 
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Параметр еп4 задает конец строки. По умолчанию использует символ \\п', 
который в \УМп4о\з автоматически преобразуется в последовательность 


\г\п’ (перевод каретки и новая строка). Обычно вам не нужно изменять 
этот параметр при выводе на экран, но может понадобиться его изменение 
при выводе в файл — все зависит от синтаксиса (формата) файла. 


Последний параметр задает файл, в который осуществляется вывод. По 
умолчанию вывод осуществляется в файл 5у3.5 Чо, что означает стандарт- 
ный вывод и обычно соответствует экрану (консоли). О работе с файлами 
мы пока не говорим, просто знайте, что функция рг!п() умеет выводить 
данные не только на экран, но и в файл. 


Вызов функции рип) без параметров позволит просто перевести строку 
(выводится пустая строка): 


рг1 пе () 


Некоторые программисты вместо функции рип) предпочитают использо- 
вать метод итйе объекта 5уз.5Чотё. Например: 


1прогЕ $5у$; 

зуз.зЕаойЕ.мг1 Ее ("Привет") 

При первом использовании метода итйе() нужно сначала импортировать 
модуль $у$, в котором определен этот метод. 


Особенность этого метода в том, что он не добавляет символ конца строки, 
поэтому его нужно при необходимости добавить самостоятельно: 


5у5.зЕаоме. ига ке ("Не11о\п") 
Для ввода данных в Руфоп 3 используется функция при). Использовать 


ее можно так: 


[<Переменная> = |] 1праё ( [ <Сообщение>] ) 


Небольшой пример: 


паме = 1при* ("Как тебя зовут? ") 
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рг10® ("Привет, ", папе) 


Работа с программой в ШГЕ: 


>>> паме = 1при* ("Как тебя зовут? ") 
Как тебя зовут? Марк 


>>> рк1п®("Привет, ", папе) 
Привет, Марк 
>>> 


Обратите внимание, что функция три) не выводит после сообщения- 
приглашения никаких символов, поэтому ввод начнется сразу после вы- 
веденного функцией сообщения, что не очень удобно. Поэтому в конец 
сообщения принято добавлять или пробел или символ новой строки, чтобы 
ввод начался с новой строки: 


>>> паме = 1прие ("Как тебя зовут?\п") 
Как тебя зовут? 
Марк 


Если пользователь нажмет СЫ] + 7 или будет достигнут конец файла (в 


данном случае речь идет о файле стандартного ввода — 5&#т), будет сгене- 
рировано исключение ЕОЕЕггог и программа завершит свою работу. Чтобы 
этого не произошло, нужно произвести обработку этого исключения: 


Ску: 
паще = 1пра® ("Как тебя зовут? ") 
рг1п® (папе) 

ехсере ЕОГЕгког: 


реп ("ЕОРЕГког га1зеа") 


Подробно обработка исключений рассмотрена не будет, а пока вам нужно 
знать, как обработать только одно из них — ЕОЕЕггог. 


1.9. Чтение параметров командной 
строки 


Вашей Ру оп-программе, как и любой другой программе, можно передать 
параметры командной строки. Они хранятся в списке агву модуля $у$. Вот 
как можно вывести все переданные программе параметры: 
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1трог® $уз 

агаз = зу$.атсду [: ] 

Еог п 1п агдз: 
рг1п* (п) 


Передать параметры программе можно так: 


руЕВоп ргоадгам.ру аг91 агд2 


В данном случае будет запущен интерпретатор Рупоп, который начнет об- 
работку программы ргоргат.ру, а самой программе при этом будут переда- 
ны параметры аг$1 и аг?2. 


На этом все. В следующих главах будут рассмотрены переменные и типы 
данных в Руфоп. 


ГЛАВА 2. 


ПЕРЕМЕННЫЕ И ТИПЫ 
ДАННЫХ 


Рупоп. Полное руководсто № 2 рутпоп 


Теперь, когда вы знаете, как создать и запустить программу, можно присту- 
пить к изучению синтаксиса языка. Прежде, чем мы перейдем к рас- 
смотрению переменных, вы должны знать, что типизация в Ру оп динами- 
ческая, то есть тип переменной определяется только во время выполнения. 
Данное отличие может поначалу сбивать с толку, особенно, если вы 
программировали на языках, где требуется сначала указать тип перемен- 
ной, а потом уже присваивать ей значение (С, Разса] и др.). В то же время 
языки с динамической типизацией тоже не редкость — типичный пример 
РНР где не нужно объявлять тип переменной перед присвоением значения. 
Тип будет определен автоматически — по присвоенному значению. С одной 
стороны, так проще. С другой - это требует от программиста постоянно сле- 
дить за данными, которые он присваивает переменной, поскольку одна и та 
же переменная в разные моменты времени может содержать данные разных 
типов. 


В Руфоп имеются встроенные типы: булевый, строка, Отисо4е-строка, 
целое число произвольной точности, число с плавающей запятой, ком- 
плексное число и некоторые др. Из коллекций в Руоп встроены: список, 
кортеж (неизменяемый список), словарь, множество и др. Все значения яв- 
ляются объектами, в том числе функции, методы, модули, классы. 
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Все объекты делятся на ссылочные и атомарные. К атомарным относятся 
116 1018 (в версии РуШФоп 3 любое число является т, так как, начиная с 
этой версии, нет ограничения на размер), сотрех и некоторые другие. 


При присваивании атомарных объектов копируется их значение, в то вре- 
мя как для ссылочных копируется только указатель на объект, таким об- 
разом, обе переменные после присваивания используют одно и то же значе- 
ние. Ссылочные объекты бывают изменяемые и неизменяемые. Например, 
строки и кортежи являются неизменяемыми, а списки, словари и многие 
другие объекты — изменяемыми. Кортеж в Ру{Поп является, по сути, неиз- 
меняемым списком. Во многих случаях кортежи работают быстрее списков, 
поэтому если вы не планируете изменять последовательность, то лучше ис- 
пользовать кортежи. 


Далее мы поговорим обо всем этом подробнее. В этой главе мы рассмотрим 
основные операции с переменными и поговорим детальнее о типах данных. 


2.1. Имена переменных 


В Руфор, как и в остальных языках программирования, есть переменные. 
Переменные в РуФоп представлены объектами. Точнее для доступа к 
объекту используются переменные. При инициализации переменной (ко- 
торая происходит при первом присваивании значения) в самой перемен- 
ной сохраняется ссылка на объект — адрес объекта в памяти. 


У каждой переменной ДОЛЖНО быть уникальное имя, позволяющее одно- 
значно идентифицировать объект в памяти. Имя переменной может со- 
СТОЯТЬ ИЗ Латинских букв, цифр и знаков подчеркивания. Не смотря на то, 
что имена переменных могут содержать цифры, они не могут начинаться с 


цифры. 


Также в именах переменной нужно избегать использования знака подчер- 
кивания в качестве первого символа имени, поскольку такие имена имеют 
специальное значение. Имена, начинающиеся с символа подчеркивания 
(например, _пате), не импортируются из модуля с помощью инструкции 
Кот тодше проге *, а имена, имеющие по два символа подчеркивания (на- 
пример, __пате__) в начале и конце, имеют особый смысл для интерпре- 
татора. 


В качестве имени переменной нельзя использовать ключевые слова. 
Просмотреть список ключевых слов можно с помощью следующих 
инструкций (рис. 2.1): 


РУпоп. Полное руководство 


>>> ппрогЕ Кеумога 
>>> Кеумога. Км115% 


(8. 1СТЕ 5ве! 39.2 о х 


Ме Еди Кей Бебид Орноп$ \М/тдом НЦер 

РУуЕНоп 3.9.2 {(+а95/93.9.2:1а79785, Ееь 19 2021, 13:44:55) [М5С у.1928 64 Б1Е (Ам ^ 
064)] оп ч1п32 

Туре "ве1р", "соруг198е", "сгеЧ15" ог "11сепзе()" Еог моге 1пЕопва®1оп. 

>>> 1ирого Ккеумога 

>>> Кеучога.Кч115% 

['Еа15е', 'М№опе', 'Тгие', '__ред_рагзег_*, ‘'ап4', 'аз', 'аззеге', 'азупс', "ама 
1Е', ‘ьтеак’, 'с1аз5', ‘советае", '4еЕ'; 'а61', ‘е11Е', ‘©1556’; ‘еховве', "Ета 
Тру‘ ЧЕог’, "бош", Тафова!, ТИВ» ЗЗарове’, "Зи, 5, "ТалЬбаа”, ‘попуосай; 


'ПОЕ", "Ор", *раз5") газе’, ‘гебуги", ‘Ету", 'чБ1ле', "лен, ‘удела 
>>> 


Рис. 2.1. Ключевые слова Рупоп 


Кроме ключевых слов в качестве имени переменных не нужно использо- 
вать встроенные идентификаторы. Конечно, Такие идентификаторы можно 
переопределить, но конечный результат будет не таким, как вы ожидаете. 


Получить список встроенных идентификатор можно с помощью следую- 
щих команд: 


>>> ипрогЕ Ри11%1п5$ 

>>> а1г (Ба11Е1п5) 

['Аг1Ермее1сЕггог', 'Аззеге1опЕгког', 'Абек1рибеЕггког", 
'ВазеЕхсер®1оп', 'В1оск1паТОЕГког', 'Вхокепр1реЕгго"", 
'ВиНегЕгког', 'ВубезМагп1па', "'Ср11АРгосез$Еггохг" 
'СоппесЕ1опАБогЕеаяЕгког", 'СоппесЕ1опЕгкгог!, 
'СоппесЕ1опВеЕазеяЕггог', "'Соппесе1опВезееЕгког', 
'Бергеса*1опМагп1па', 'ЕОЕЕггог', 'Е111р5$15', 
'Епу1гопмепЕЕгког', 'Ехсер&1оп', "'Ра15е', 'Е11еЕх1зЕ5Еггог' 
'Р11еМоеЕоцпаЕггог', 'ЕР1оа&1парРо1пЕЕгког', 'Габогемагп1па', 
'СепегафохЕх1', 'ТОЕгког', 'ТпрогЕЕгког', 'ТпрогЕМагп1па', 
'Тпдепеае1опЕкгког', 'ТпаехЕггог', 'ТпееггарбеаЕггог', 
'1Т5АО1кесеогуЕгког', 'КеуЕггог', 'КеуроагаТптееггире', 
'БоокКирЕггог', 'МетогуЕггог', 'МамеЕгког', 'Мопе', 
'МосАО1гесвогуЕггог', 'МоЕТпир1етепфеа', 'МоЕТир1етепЕеЯЕггог', 
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'ОЗЕггог', 'ОуегНомЕггог', 'Репа1паПергеса*1опМагп1па', 
'Реги13з1опЕггог', 'РгосеззЬоокирЕггог', 'ВеЕегепсеЕггог', 
'Везоигсемагп1тпа", 'ВопЕ1меЕггог', 'ВопЕ1темагп1та', 
'ЗЕорТбегаЕ1оп', 'бупбахЕггог', 'бупбахИМагп1па', 
'ЗузЕешЕггог', 'бузеемЕх1е', 'ТарЕггог', 'ТлмеосЕЕггог', 
'Тхие', 'ТуреЕггог', 'ОпроппаЬоса1Етгог', 
'Оп1тсоаересоаеЕггог', 'Оп1содеЕпсоаеЕггог', 'Оп1соаеЕггохг!', 
'Ор1соаеТгап$1а еЕггог', 'Оп1соаемагп1па', 'ОзегМагп1па', 
'Уа1аеЕггог', 'Магп1па', 'И1паомзЕггог', 'бегор1\у1з1олЕггог', 
"15 М 50119, 61455 “к " аБыя *, * а0е *„ " прове № 
' __1оааег _', '_паме__', ' раскаде__', '_ зрес__', 'аЪз', 
'а11"„ зайу”, "азс", 'Ба“, "Боб", “"Бувеагкау“", 'БуЕез’,, 
'са11аЪ1е', 'сВг', 'с1аззмеЕроа', 'сотр11е', 'сопр1ех', 
"сорусщане", "стеазе-“, 'аелаеЕеЕ“, "ащее“, "ат, ‘азутоа!,, 
'епопехаее"“,; "ела", ‘ежес*“, чехи“. чет", "Ноа", 
'Еогтае', 'Егогепзее', ‘'дебафег', '91ора1з', 'ВазаЕЕг', 
‘Пазбя "Не]фр", "'вех”, '1а'„ ‘тарае’, "тие, ‘шоалэталсе", 
"75500 ста55т,. Таек", ‘еп; *]ибёйзе", "Пе, "оса", 
"пар"; "пах', "‘петшогуутем", "ити", "пехе', тоБ]есе*,; "'осе", 
'ореп', 'ога', 'ром', 'рг1пе', "'ргорегеу', '4а16Е', 'гапае', 
'герг', 'геуегзеа", 'гоппа', 'зеё', "'зефаеег', '5$11се', 
"зогЕеа, "збаростееноя", ‘зе, "5", “зорег", 'Барте", 
"Буве’я "уаше*; ‘а р"] 


Итак, если подытожить, то можно выделить следующие правила: 


® Имя (идентификатор) может начинаться с латинской буквы любого ре- 
гистра, после которой можно использовать цифры. Пример правильных 
имен переменных: 41, гези!{ 1, а, Х, МуУаг 


® Имя переменной не может начинаться с цифры. Пример неправильных 
имен переменных: 14, 1гези]& 


® Имя переменной может начинаться с символа подчеркивания, но такие 
имена имеют специальное значение для интерпретатора. Примеры таких 
имен: _гезоигсе, __гезоитгсе __ 


® Имя переменной не может быть ключевым словом 
е Лучше не переопределять встроенные идентификаторы 


® Имя переменной должно быть уникальным в пределах пространства 
имен 


РуУ{поп. Полное руководство =. ру{Поп 


Примечание. Теоретически, имя переменной может содержать 
символы национальных алфавитов, но лучше такие имена не 
использовать. 


Немного забегая вперед, хочется поговорить о пространствах имен. В лю- 


бой точке программы есть доступ к трем пространствам имен (патезрасе$): 
локальному, глобальному и встроенному. В других языках программирова- 
ния они также называются областями видимости. 


Сложность скриптовых (интерпретируемых) языков программирования 
вроде РНР и Ру!оп заключается в том, что переменную можно объявить 
в любой части программы. В результате вы можете не заметить, как пере- 
менные в разных пространствах имен просто перемешались, не забыть об 
объявлении переменной и т.д. Например, в том же языке Разса| перемен- 
ные объявляются в блоке Уаг, который вынесен за пределы основного блока 
кода. Рассмотрим небольшой пример программы на Разса|: 


ргоагам УагТезе; 
уах 
а, Ю : геа1; 


Еорсе1оп зом (а : геа1; Ь : геа1): геа1; 
уаг 

гез : геа1; 
Беа1п 

вез = а № В 

зим := гез; 
епа; 
Бед1п 

а = 2; 6 := 2; 

мг фе]п (зом (а, ББ); 
епа. 


Четно видно, что переменные а и Ь являются глобальными, поскольку 
определены за пределами какой-либо функции, а переменная гез является 
локальной, поскольку она объявлена в функции зит. В принципе, без нее 
можно было бы обойтись, но нужен был пример локальной переменной, а 
усложнять код не хотелось. 


В Рушоп также есть понятие глобальной и локальной переменной. Локаль- 
ными считаются переменные, объявленные внутри функции (о функциях 
мы поговорим позднее). Простота Разса!| (и многих других переменных) в 
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том, что переменные объявляются в одном блоке (уаг), при этом жестко 
определен тип переменной. 


В Руфоп (как ив РНР) все иначе. Какого-либо оператора или блока объ- 
явления переменной просто не существует. Объявлением переменной счи- 
тается присваивание ей значения. Вот у вас может быть программа на 2000 
строк и переменная гез, хранящая результат, может встречаться лишь в 
предпоследней строке. И это будет правильно с точки зрения РуФоп. 


С типом переменной тоже не все так просто. Если в С типы определяются 
жестко — при объявлении переменной, то в Руфоп типы плавающие: 


ых = 1 
ых = "жезЕ" 
>>> ретшЕ (х) 
ее 

>>> 


Сначала переменная х была у нас целым числом. Затем она превратилась в 
строку со значением "{ез(". Попробуйте вы проделать такое в Разса] или С — 


вы получите ошибку несоответствия типа - ну нельзя переменной, которая 
была изначально запланирована для хранения числа, присвоить строку. В 
Руоп такое возможно, что тоже не добавляет ясности вашим программам. 
Поэтому при использовании переменных в Руфоп нужно быть очень вни- 
мательным. 


Я рекомендую, особенно начинающим программистам, объявлять все не- 
обходимыепеременные в начале вашей программы путем присваивания им 
начальных значений. Если начального значения нет, используйте 0 для чис- 
ла или "" для строки. Также комментируйте назначение переменных, если 
по их имени нельзя однозначно сказать, для чего они предназначены. Так 
вам будет гораздо проще и вы привыкните к некоторой дисциплине. 


Также рассмотрим некоторые рекомендации, позволяющие навести поря- 
док в вашем коде и сделать его более удобным для чтения и поддержки в 
будущем: 


1. Хотя переменную можно объявить в любом месте программы, но до 
первого использования, рекомендуется объявлять переменные в начале 
программы. Там же можно произвести инициализацию переменных. Об 
этом мы только что говорили. 


2. Неплохо бы снабдить переменные комментариями, чтобы в будущем не 
забыть, для чего используется та или иная переменная. 


Рупоп. Полное руководство №9 #2: рутпоп 


& 


Имя переменной должно описывать ее суть. Например, о чем нам гово- 
рит переменная $? Это может быть все, что угодно и сумма (5итт), и 
счет ($соге) и просто переменная-счетчик, когда вы вместо 1 почему-то 
используете $. Когда же вы называете переменную $соге, сразу становит- 
ся понятно, для чего она будет использоваться. 


Придерживайтесь одной и той же схемы именования переменных. На- 
пример, если вы уже назвали переменную |151 _зсоге (нижний регистр и 
знак подчеркивания), то переменную, содержащую текущий счет поль- 
зователя называйте изег_зсоге, но никак не изегЗсоге. С синтаксической 
точки зрения никакой ошибки здесь нет, но код будет красивее, когда 
будет использоваться одна схема именования переменных. 


Традиции языка Руоп рекомендую начинать имя переменной со строч- 
ной буквы и не использовать знак подчеркивания в качестве первого 
символа в имени переменной. Все остальное - считается дурным тоном. 


Не создавайте слишком длинные имена переменных. В таких именах 
очень легко допустить опечатку, что не очень хорошо. Да и длинные 
имена переменных сложно "тянуть" за собой. Если нужно использовать 
в одной строке несколько переменных, то длинные названия будут вы- 
ходить за ширину экрана. Максимальная рекомендуемая длина имени 
переменной - 15 символов. 


2.2. Типы данных 


В Ру оп есть типы данных. При присвоении переменной значения тип дан- 
ных выбирается автоматически, согласно присваиваемому значению. Тип 
данных может меняться на протяжении протяжение программы несколько 
раз — столько раз, сколько ей присваивают значения разных типов. Под- 
держиваемые типы данных приведены в таблице 2.1. 


Таблица 2.1. Типы данных в Рутоп 


Тип данных Описание 


Логический тип данных. Может содержать только два 
Бос] значения — (тие (истина) или /абе (ложь), что соответ- 
ствует числам 1 и 0 
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Бубеаггау Изменяемая последовательность байтов 
Буе$ Неизменяемая последовательность байтов 


{гозепзее 


Гипсбоп 


сотр!ех Комплексные числа 
дс Словарь. Похож на ассоциативный массив в РНР 
РЕ Используется для получения среза. Определяется или 
ключевым словом Ер$15 или тремя точками 
Ноае Вещественные числа 


Неизменяемое множество 


Функция 


тодше 


Целые числа. Размер числа ограничен только размером 
доступной оперативной памяти 


Список. Аналогичен массивам в других языках програм- 
мирования 


Пустой объект, объект без значения (точнее со значением 
М№опе, что в других языках соответствует ии!) 


Множество (набор уникальных объектов) 


Очсоде-строка 


Рупоп. Полное руководство оно [5 ру{Поп 


Типы и классы данных 


Узнать тип данных можно с помощью функции ®уре(): 


>>> фуре (х) 
<с1азз '10е'> 
>>> х = "абс" 
>>> туре (х) 
<с1азз '56г'> 


Все типы данных в Руфоп можно разделить на неизменяемые и изменяемые. 
К неизменяемым типам данных относятся числа, строки, кортежи и Бусез. К 
изменяемым относятся списки, словари и Бубеаггау. 


Также можно говорить о последовательностях и отображениях. К последо- 
вательностям относятся строки, списки, кортежи, типы Буёе$ и Буеаггау. К 
отображениям - словари. 


Последовательности и отображения поддерживают механизмы итераторов, 
который позволяет произвести обход всех элементов с помощью метода __ 
пех _() или функции пехё. Пример: 


р И В, 2 3] 
>>> 1 = цек (п) 
>>> 1. пехЕё () 
НЕ 

>>> пех (1) 

2 

>>> пех (1) 

3 

>>> 


Использование метода __пех*__() и функции пех) на практике на- 


блюдается редко. Чаще всего используется цикл Гог п: 


>>> Еог т шп: 
рг1пЕ (1) 
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Списки, кортежи, множества и словари будут рассмотрены в следующих 
главах, а пока рассмотрим, как в Ру оп осуществляется присваивание пе- 
ременной значения. 


2.3. Присваивание значений 


Для присваивания значения используется оператор =. Переменной, какив 
другом языке программирования, вы можете присвоить: 


® Обычное значение (константу): 


х =1 # Переменной х присвоено значение 1 (число) 
Е1гз& Маше = "Оеп13" # Переменной присвоена 
строковая константа "Беп13" 


® Значение другой переменной 


а = 


® Результат вычисления выражения 


ух * ах 


® Результат вычисления функции 


гез = Еапс (у) 


Как уже отмечалось, в Руоп используется динамическая типизация, то 
есть тип данных переменной изменяется в зависимости от присваиваемо- 
го ей значения. После присваивания значения в переменной сохраняется 
ссылка на объект, а не сам объект. Это обязательно следует учитывать при 
групповом присваивании. Групповое присваивание можно использовать 
для чисел, строк и кортежей, но этого нельзя делать для изменяемых объ- 
ектов. Рассмотрим небольшой пример. Судя по следующему коду, мы соз- 
дали два разных объекта: 


>>> а=ьЬ = [5, 4, 3] 
>>> а, Ь 
([5, 4, 3], [5, 4, 3]) 


РУпоп. Полнсе руководство мм [5 ру+Поп 


Е] 
(056, 3], 5, би ЗГ) 


Как видите, в переменной хранится только ссылка на объект, а не сам 
объект. Поэтому в переменных а и Ь содержится ссылка на один и тот же 
объект. Следовательно, изменение одной переменной приводит к измене- 
нию значения и другой переменной, точнее к изменению объекта, на кото- 
рого ссылается вторая переменная. 


С числами, которые являются неизменяемыми объектами, вполне можно 
использовать групповое присваивание и получить ожидаемый результат: 


>>> а=р = 1 
>>> а=2 
>>> а, Б 

(2, м) 


Проверить, ссылаются ли переменные на один и тот же объект, можно с по- 
мощью оператора 1$. Например: 


>>> а=ьЬ = [5, 4, 3] 

>>> а 15 Ь 

Тгие 

>>>. 515 .а 

Тгие 

Как видите, оператор 1$ вернул значение Т7ие, что означает, что переменные 
аи Ь ссылаются на один и тот же объект в памяти. А теперь не будем ис- 
пользовать групповое присваивание, но присвоим переменным а и Ь одно 
и то же значение: 


>>> а = 15, м, 3 
>> м = |5, 4, 3] 
>>> а 18. 

Еа1зе 

>>> раза 

Еа1зе 


Теперь переменные а и Ь ссылаются на разные объекты в оперативной па- 
мяти. Просмотреть, сколько ссылок есть на тот или иной объект, можно с 
помощью метода зуз.зеёгесоип®(): 


>> а =: = об; 
>>> зуз.деетгеЕсочпе (5) 
105 
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Когда число ссылок на объект станет равно 0, объект будет удален из памя- 


ТИ. 


Кроме группового присваивания в Руоп поддерживается позиционное 
присваивание, когда нужно присвоить разные значения сразу нескольким 
переменным, например: 


>>> ар 5; 5.5 Ш. З 
ам В, ие 
(5; 4; 3 


По обе стороны оператора = можно указать последовательности (строки, 
списки, кортежи, Бу{ез и Бу{еаггау), но такие сложные операторы присва- 
ивания встречаются в "природе" довольно редко и я бы рекомендовал из- 
бегать их использования, если вы хотите сделать программу понятной и 
читаемой: 


>>> а, Ь, с = "абс" 

>>> х, у, 2 

(паи ‘5’; 

>>> а зь, @: = М, 2, 3 
225 а, Бе 

(и 2, 3) 

>>> Га, Вл с] =, 2 З 
>>>. ар Би 

(1; 2 3) 


Количество элементов слева и справа должно совпадать, иначе вы получите 
сообщение об ошибке: 


>>> а в, @=л 2 
ТгасебасК (моз® гесеп® са11 1аз®): 
Е11е "<рузре11#49>", 11пе 1, 1п <поао1е> 
а, 65, се, 2 
Уа1пеЕггог: пее моге ЕВап 2 уа1аез о ппраск 
>>> 


Если справа от оператора = указано больше значений, чем переменных сле- 
ва, все лишние элементы могут быть помещены в последнюю переменную. 
Для этого перед этой переменной нужно указать звездочку (*): 


>>> а, 5; *=1, 4.34“ 
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>>> а, Ь, с 
(2; 9; 4) 
>>> 


Однако такая возможность появилась в Руоп Зив Руоп 2.7 она не под- 
держивается. 


Примечание. Звездочку можно указать только перед одной пе- 
ременной, иначе получите следующую ошибку: 


ЗупЕахЕггог: Емо зЕагге ехрге551оп$ 1п 
а551аптепё 


2.4. Проверка типа данных и 
приведение типов 


Как уже отмечалось ранее, функция й/ре() позволяет определить тип пере- 
менной. Например: 


>>> а = "1" 
>>> туре (а} 
<е1азв 'эеЕ'> 
>>> 


Данную функцию можно использовать не только для вывода типа, но и для 
сравнения возвращаемого нею значения с названием типа данных: 


>>> 1Е Фуре(а) == 5э%г: 
реп ("5 еЕаа"); 


ЗЕг1п9 
Иногда нужно преобразовать один тип данных в другой. Эта операция на- 


зывается приведением типа. Стоит отметить, что далеко не всегда можно 
преобразовать один тип данных в другой без потери самих данных. Неко- 
торые типы данных вообще не совместимы. Например, никак нельзя преоб- 
разовать вещественное число в целое без потери данных. А при преобразо- 
вании строки в число вы вообще увидите сообщение об ошибке: 
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>>> 1ае("5Егапа") 
Тгасераск (мозЕ гесепЕ са11 1аз%): 
Е1]е "<рузЬе11#60>", 11пе 1, 1п <тоаа1е> 
ое" оветио) 
Уа1оеЕггог: 1пуа11а 11$ега]1 Гог 1пе() м1ЕВ Базе 10: '5Ег1пд' 
В таблице 2.2 перечислены функции приведения типов, а также примеры 
их использования. 


Таблица 2.2. Функции приведения типов 


Преобразование объекта в логиче- | >>> оо] (1) 
ский тип данных Тгие 


Преобразование объекта в целое | „>> 1+ 5.5 
число. Обратите внимание: дробная | 5 
часть потеряна 


Преобразование целого числа в ве- | >>> ПНоа+ (5) 
щественное 5.0 


>>> ЗЕк(1[5; 4, 31) 
Преобразование объекта в строку 5 м з 


Преобразует строку в объект типа 

Буе$0. Первый параметр - ЭТО | >>> Букез ("ЗЕ кпд", 
строка, второй — кодировка, третий | "и =_В") 

параметр необязательный и может | "бег па' 

указывать способ обработки ошибок 

(зесь, герЙасе, 1епоге) 


>>> 


Преобразует строку в объект типа | Рукеагкау ("Не11о", 


Буеаггау "ИЕЕ-8") 
русеаггау (р'Не11о') 


>>> 1156 ("Не11о") 
Используется для преобразования [^ 5", Же, 5, 


последовательности в список ']1', '0о'] 
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ру{Поп 


>>> Гарте ("Не11о") 
Преобразует последовательность в ('Н', 'е', '1', 


кортеж и 


'о') 


Зачем необходимо преобразование типов, если в Руфоп используется ди- 
намическая типизация и типы приводятся автоматически? Далеко не всег- 
да функции возвращают значения в ожидаемом типе. Представим, что нам 
нужно написать простейшую программу, вычисляющую сумму двух чисел, 
введенных пользователем: 


х = 1приЕ ("Введите х А") 
у 1приЕ ("Введите у = \п") 
ретпёе(х + у) 

1прие () 


Запустите программу и введите числа 5и 7. Хотя вы ввели числа, функция 
шри\&() всегда возвращает введенное значение, как строку. В результате вме- 
сто числа 12 вы увидели строку 57 (рис. 2.2). 


с 1ОЕЕ бпей 3.9.2 хх о х 


{1е Еай зрей Ребид Орбоп$ \Мтаом Нер 

РуЕпоп 3.9.2 (а45/%3.9.2:1а797285, Ееь 13 2021, 13:44:55} [М5$С х.1928 64 Б1е (АМ ^ 
564)] оп *11п32 

Туре "Ве?р", "сорух198®", "сгеа15" ог "11сепзе{)" Рог поге 1пРогпа®1оп. 

>>> х = 1прае ("В ежа №") 

Введите х = 

] 

>>> у = зприЕ{”Зве 
введите у = 

7 

>>> резпЕ(х + у} 
5? 

>>> 


в у = \5*} 


[7:11 СоЕ4 


Рис. 2.2. Неожиданный результат работы программы 


Изменим программу так: 


х = Ноа (1при® ("Введите х = \п")) 
Поаф (1приф ("Введите у м 


‘< 
Н 
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рг1пё (х + у) 
1прие () 


Здесь мы приводим введенное пользователем значение к типу Яоав, а затем 
вычисляем сумму двух вещественных чисел. В результате получаем значе- 
ние 15.0, что соответствует нашим ожиданиям (рис. 2.3). 


№ 1ОЕЕ $пен 3.9.2 = О х 

Ее ЕЧи Звей ребид Ориоп5 \Мутаом Нер 

тур= педы у, соруЕЗЧИС ; стгеатез 9: УЕОЕПЬЕЛ, ГОЕ ПЕСТИгОЕШАаском.: о х 

>>> х = 1прий ("Введите и = \п") 

введите х = 

5 

>>> у = зпри{ ("Введите у = \п") 

Введите у = 

7 

>>> ргтпЕ(х + у} 

Е) 

>>> х = Е1оаф (1прит ("Введите х = \%п")) 

Введите х = 

5 

>>> у = Ефоа* (1при{ ("Введите у = \0")) 

Введите у = 

7 | 

>>> резпе(х + у} | 

12.0 | 

>>> | м] 
7: 19 Соё4 


Рис. 2.3. Теперь программа работает, как нужно 


2.5. Удаление переменной 


Для удаления переменной используется инструкция 4е!: 


е1 <переменная1>[, .., <переменнаяМ>] 


Пример: 


>>> 2 =1 
>>> рг1 ПЕ (2) 
1 
>>> ае1 2 
>>> рг1пЕ (2) 
ТгасебасКк (позе гесеп® са11 1аз®): 
Е11е "<рузре11#72>", 110е 1, 1п <моди1е> 
рг1пЕ (2) 
МатеЕггог: паме '72' 1$ поЕ аейпеа 
>. 


РуУпоп. Полное руководство } 


Чтобы удалить несколько переменных, просто перечислите их в инструк- 
ции 4е! через запятую: 


ае] а, Ь, с 


ГЛАВА 3. 


ОПЕРАТОРЫ 


Рупоп. Полное руководство МО 2. ру&Поп 


Операторы производят определенные действия с данными. Например, ма- 
тематические операторы выполняют арифметические вычисления, двоич- 
ные операторы — производят манипуляции с отдельными битами данных 
ИТД. 


3.1. Математические операторы и 
работа с числами 


3.1.1. МАТЕМАТИЧЕСКИЕ ОПЕРАТОРЫ 


Числа - немаловажный элемент любой компьютерной программы. Можно 
сказать, что ни одна мало-мальски полезная программа не обходится без 
применения чисел. 


Как и в любом другом языке программирования (ну, почти в любом), в 
РуПоп имеются следующие базовые математические операторы (табл. 3.1). 
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Таблица 3.1. Математические операторы в Рутоп 


Оператор Действие 
+ Сложение 
- Вычитание 


Умножение 


/ Обычное деление 
// Деление с остатком 
% Остаток от деления 


Возведение в степень 


Результатом оператора / всегда является вещественное число, даже если вы 
делите два целых числа и нет остатка. Вам кажется, что так и должно быть? 
В принципе да, в Ру оп 3 так и есть. А вот в Руфоп 2 при делении двух 
целых чисел возвращалось целое число, а остаток просто отбрасывался. В 
Руоп 3 оператор деления работает, как обычно. 


Теперь рассмотрим примеры использования математических операторов. 
Обязательно обратите внимание на используемый тип данных операндов и 
тип данных возвращаемого результата: 


>> 2-2 # Два целых числа, результат - целое число 
4 
р рщажнгй # Одно целое, одно вещественное, результат - 


вещественное 
4.5 

>>> 2.5 +2.5 + Два вещественных, результат - вещественное 
5..0 

>>> 100: =20 

80 

>>> 100.5 - 80.5 

20.0 

о .5 

25 

рев рю. мБ. 25 

27 :95625 

> 9-Я 2.5 

2..5 


РУпоп. Полное руководстто Ммм [= ру4поп 


# Обратите внимание на разницу между операторами / и // 


>>> 100 / 20 
5:0 
>>> 100 / 33 

3.0303030303030303 
>>> 100 // 5 

20 
>>> 100 // 33 
3 


>>> 100 $ 33 

и 

55>: © *ьР 

4 

>>> +100, -20, -5.0 
(100, -20, -5.0) 
>>> 


При выполнении операций над вещественными числами нужно учитывать 
точность вычислений, иначе вы можете получить довольно неожиданные 
результаты. Например: 


У». 5 = .0. 1 2= ФТ = ЕТ 
0.20000000000000004 

>>> 0.5-0.1-=0.1-0.1 - 01= 9 
2.7755575615628914е-17 


В первом случае результат вполне предсказуем -— мы получили 0.2. А вот во 
втором случае мы ожидали 0, а получили значение, отличное от нуля. 


Поэтому если вы разрабатываете финансовые приложения на Руоп, где 
важна точность, лучше использовать модуль Оесйпа!: 


>>> Егош Аес1та1 1ирог® Рес1ща1 

>>>. раслаа “0: 5") = Веста! (“0..7”) = Бастщай. ("0:1") = 
Веслмал ("0.1") = Рееслща1 ("0:1") = Бесма1 ("0.1") 
Рес1та1 ('0.0') 


3.1.2. ПРИМЕР: ВЫЧИСЛЕНИЕ ВРЕМЕНИ В ПУТИ 


Напишем небольшую программу, вычисляющую время автомобиля в пути. 
Пользователь должен будет ввести расстояние, которое нужно проехать, а 
также планируемую среднюю скорость автомобиля. 
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Листинг 3.1. Вычисление времени в пути 


91$е = 0 # Расстояние, которое нужно проехать 
зрееа = 0 $ Средняя скорость авто, км /ч 


915$Е = 110% (1при® ("Расстояние: ")) 
зрееа = 11% (1при* ("Планируемая средняя скорость: ")) 


Е1ме = 49136 * 60 / зрееа 
рг1п® ("Время в пути ", &1ще, " минут.") 


Посмотрим, что есть в нашей программе. Первым делом мы инициализиру- 
ем две переменные - 415% и зрее4. РуШфоп не требует обязательной иници- 
ализации переменной. Мы сделали это так, чтобы добавить комментарий и 
знать, для чего используется та или иная переменная. 


Далее мы получаем расстояние и среднюю скорость: 


91$Е = 11 (1пруиё ("Расстояние: ")) 
зрееа = 1п% (1при ("Планируемая средняя скорость: ")) 


Обратите внимание: мы используем преобразование типа и явно указыва- 


ем, что прочитанное значение должно быть типа 114. 


Затем мы вычисляем время движения автомобиля по формуле: 


$1ме = 413зЕ * 60 / зрееа 


60 здесь — количество минут в одном часе. После того, как время вычислено, 
мы его выводим. 


ЫЖ ОКЕ $пеи 3.9.2 О х 


Ее ЕЧй лей Ребуд Орноп$ Утаом Нер 

РуЕпоп 3.9.2 ({а95/93.9.2:1а79785, Кеь 19 2021, 13:44:55) [№М5С ч.1928 64 Ы1 {АМ ^ 
064)] оп м1п32 

Туре "Не1р", "соруг19ВЕ", "сгеЧ91+5" ог "11сепзе()" Еог тоге 1пЕогва1оп. 

>>> 


—-=—-- =—--—--—--—- ВЕЗТАВТ: С:\Еетр\ру\Е ие .ру 


Расстояние: 120 

Планируемая средняя скорость: 80 
Время в пути 90.0 минут. 

>>> | 


Рис. 3.1. Результат работы программы 


р руно 
3.1.3. ПРИМЕР: ВЫЧИСЛЕНИЕ РАСХОДА ТОПЛИВА 


Данный пример демонстрирует работу с дробными числами. Ранее мы вы- 
числяли время в пути и вводили два целых параметра. Теперь мы будем так- 
же вводить два параметра, но они с большей долей вероятности могут быть 
дробными. 


Листинг 3.2. Вычисления расхода топлива 


соп5им 0 # Средний расход 10.5 л/100 км 
91$Е = 0 # Расстояние, км 


сопзим = Ноаф (1приф ("Средний расход топлива л/100 км: ")) 
41$Е = Ноа* (1при* ("Расстояние, км:")) 


гези1& = сопзим * 415 / 100 


рг11п* ("Необходимо ", гкези1е, " л.") 


Принцип программы такой же, как в предыдущем случае, но мы хотим по- 
лучить дробные значения, поэтому мы используем функцию Лоа{(), кото- 
рая приводит строковое значение к дробному. 


Внимание! Обратите внимание, что в качестве разделителя це- 
лой и дробной части используется точка, а не запятая! То есть, 
если вы введете 10.5, программа будет работать, а если вы вве- 
дете 10,5, то получите сообщение об ошибке: 


ОЕ $вей 3.9.2 
Не Ед" ей Бебид. Ориоп$ М/пдом Нер 


Средний расход топлива л/100 км: 11 
Расстояние, км:660 
Необходимо 72.6 л. 


——с ВЕЗТАВТ: С:\$епр\ру\Ьс1.ру 
Средний расход топлива л/100 км: 11 

Расстояние, км:80 

необходимо 8.8 л. 

>>> 

ЕЕ —= ВЕЗТАВТ: С:\6емр\ру\Ьс1.ру 
Средний расход топлива л/100 км: 18 

Расстояние, км:100 

Необходимо 18.0 л. 


Глава 3. Операторы 


ТгасерасКк (позе гесепЕ са11 1аз®): 
Е11е "Е: /РуЕроп39/затр1ез/3-2.ру", 11пе 4, 1п <тодо1е> 
сопзим = Поаф (1проф ("Средний расход топлива л/100 км: ")) 
Уа1пеЕггог: соп1а поЕ сопуегЕ зЕх1па фо Ноа®: '10,5' 


Данное сообщение говорит о том, что невозможно конвертировать строко- 
вое значение "10,5" в Ноа(-значение. 


3.1.4. ВЫБОР ПРАВИЛЬНОГО ТИПА ДАННЫХ 


В предыдущих примерах мы явно применяли 11 () и Доа(() для приведения 
прочитанного с ввода значения к числовому типу. А что будет, если не вы- 
полнять приведения типа? Давайте посмотрим. Напишем программу, под- 
считывающую стоимость содержания автомобиля. 


Листинг 3.3. Стоимость содержания автомобиля 


зегу1се = 1при® ("Стоимость ТО: ") 

Еце1 = 1при® ("Стоимость топлива: ") 

ах = 1при* ("Транспортный налог: ") 

Сип1п9 = 1приф ("Тюнинг и прочие доработки: ") 
1пзикапсе = 1проа® ("ОСАГО: ") 

Соса] = зегу1се + ЁЕле1 + фах + Кап1па + 1пзагапсе 
Рети ("Всетой ", вова) 


Вывод изображен на рис. 3.3. Явно не то, что мы хотели. По умолчанию все 
введенные значения считаются строковыми, и интерпретатор просто скле- 
ил строки в одну большую строку. 


а окыы ВЕЗТАВТ: С:\Сепр\ру\со5е.ру ============ыве=аенекнные 
Стоимость ТО: 15000 

Стоимость топлива: 154000 

Транспортный налог: 32000 

тюнинг и прочие доработки: 50000 

ОСАГО: 6000 

Всего: 1500015400032000500005000 

>>> 


Рис. 3.3. Стоимость содержания автомобиля. Ошибка! 
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Именно поэтому нам нужно явно указывать тип прочитанного значения. 
Исправим ошибку (рис. 3.4). 


зег\у1се = Ноа® (1при* ("Стоимость ТО: ")) 

Еие1 = Ноа (1приаё ("Стоимость топлива: ")) 

фах = Ноа (1при® ("Транспортный налог: ")) 

Фип1па = Ноа® (1приа* ("Тюнинг и прочие доработки: ")) 
1пзигапсе = Ноа* (1приа® ("ОСАГО: ")) 


фофа1 = зеку1се + ЁЕие1 + фах + Еип1па + 1пзикапсе 


рг1пе ("Всего: ", 0%а1) 


Теперь, думаю, вы понимаете, зачем мы использовали #1{() и Лоа(() в преды- 
дущих примерах. 


фа. ТРЕЕ пей 3.9.2 _ О х 
Ее Еди Зпей Оебид Орцоп$ Митаом Нер 
"СавимосжЕлво: ние 
Стоимость топлива: 154000 
Транспортный налог: 32000 

Тюнинг и прочие доработки: 50000 


ОСАГО: 6000 
Всего: 1500015400032000500006000 
>>> 


Стоимость ТО: 15000 

Стоимость топлива: 154000 
Транспортный налог: 32000 
Тюнинг и прочие доработки: 50000 


ОСАГО: 6000 
Всего: 257000.0 
>>> | 


Рис. 3.4. Стоимость содержания автомобиля. Правильная версия 


3.2. Операторы для работы с 
последовательностями 


Операторы ДЛЯ работы с последовательностями используют в качестве сво- 
их операндов последовательности — строки, списки, кортежи. Кэтим опера- 
торам относят следующие: 


е + — конкатенация; 
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е * — повторение; 


® ш — проверка на вхождение. 


Примеры использования операторов: 


>>> "Не11о, " + "мог1а!" # Строки 
'Не11о, мог1а!' 

2 НТ, 2, 1 Ч, м, 6 # Списки 
[а 3? 5. 6] 

>>>. (1, 2) ч (3, 4) # Кортежи 
(И, 3 


Оператор + объединяет две последовательности. 


>>> "а" * 5 
'ааааа' 

>>> 1] * 5 
а] 
>>> (1, 2) * 3 
Пой а, 2) 


Оператор ы создает новую последовательность. В качестве Исходной после- 
довательности используется последовательность, заданная слева, а операнд 
справа задает количество повторов указанной последовательности 

>>>. 15" аи "ОЕ" 

Еа15е 

>>> "5" ла "бела а" 


Тгое 
> 3 на [1 2, "31 
Тгие 
>2>34 ам (5, 5, 5) 
Еа1зе 


Как видите, оператор вхождения (т) возвращает Тгие, если операнд слева 
входит в состав последовательности, указанной операндом справа. В про- 
тивном случае оператор возвращает Еа[зе. 


3.3. Операторы присваивания 


Операторы этой группы используются для сохранения значения в перемен- 
НОЙ: 


® = — присваивает переменной значение 
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® += — увеличивает значение переменной на указанную величину (или 
производит конкатенацию - для строк) 

® -- — уменьшает значение переменной на указанную величину 

® *= — умножает значение переменной на указанную величину (для строк 
этот оператор означает повтор) 

® /= — делит значение переменной на указанную величину 


® //= — ТО же, что и /=, но деление происходит с округлением вниз и при- 
сваиванием 


е %=— деление по модулю и присваивание 


® **— — возведение в степень и присваивание 


Примеры (следите за возвращаемым значением): 


>>> а = 10; а 


В] 

>>> а += 5; а 

15 

>>> 5 = "Не!"; $ += "10"; $ # Для строк конкатенация 
'Не11о' 

>>> а -= 5; а 

10 

>> а *= @; а 

20 

>>. 3 *= 2.5 # Для строк - повтор 
'Не11оНе11о' 

>>> а /= 2; а 

1:0.:0 

>>> а //= З; а 

3.0 

>>> а %= 2; а 

1-0 

>>> а = ба # Возведение в степень 1 ^ 5 = 1 
1.0 


3.4. Двоичные операторы 


В современном мире вы будете редко иметь дело с двоичными операторами, 
разве что захотите разработать какой-то свой собственный алгоритм шиф- 
рования. Двоичные операторы используются для манипуляции над отдель- 
ными битами: 
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® - — двоичная инверсия (значение бита изменяется на противоположное: 
1 на 0, О на 1) 


® & — двоичное И 
® |— двоичное ИЛИ 
® ^ — двоичное исключающе ИЛИ 


® << — сдвиг влево (сдвигает двоичное представление числа влево на один 
или несколько разрядов, разряды справа заполняются нулями) 


® >> — СДВИГ вправо (сдвигает двоичное представление числа вправо на 
один или несколько разрядов, разряды слева заполняются нулями, если 
число положительное, аесли число отрицательное — единицами) 


3.5. Приоритет выполнения 
операторов 


Последовательность вычисления выражений зависит от приоритета выпол- 
нения операторов. Все мы знаем, что сначала выполняются умножение и де- 
ление, а потом уже сложение и вычитание, поэтому результат следующего 
выражения будет 6, а не 8: 


аи ор А 


Это основы. Но в Ру оп операторов гораздо больше, чем в математике, по- 
этому нужно учитывать приоритет каждого оператора. Далее приведены 
операторы в порядке убывания приоритета. Операторы одного приоритета 
выполняются слева направо: 


1. -х, +х, -х, ** 
а ЖИ 
В = 

в >> 


& 
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Если вам сложно запомнить приоритет операторов, хочется большей одно- 
значности или нужно изменить приоритет выполнения, используйте скоб- 
ки. Резульгатом следующего выражения будет уже 8, а не 6: 


АИ 2 т К 


Сначала будет вычислено значение в скобках (4), а потом уже будет произ- 
ведено умножение на 2. 


3.6. Простейший калькулятор 


Для закрепления материала о различных операторах разработаем простей- 
ший калькулятор, то есть программу, умеющую выполнять над двумя ве- 
щественными числами арифметические операции (сложение, вычитание, 
умножение, деление) и завершающуюся по желанию пользователя. 


Наш калькулятор будет работать так: 


1. Запустить бесконечный ЦИКЛ. Выход из него осуществлять с ПОМОЩЬЮ 
оператора ЬгеакК, если пользователь вводит определенный символ вме- 
сто знака арифметической операции. 


2. Если пользователь ввел знак, который не является ни знаком арифмети- 
ческой операции, ни символом - "прерывателем" работы программы, то 
вывести сообщение о некорректном вводе. 


3. Если был введен один из четырех знаков операции, то запросить ввод 
двух чисел. 


4. В зависимости от знака операции выполнить соответствующее арифме- 
тическое действие. 


5. Если было выбрано деление, то необходимо проверить, не является ли 
нулем второе число. Если это так, то сообщить о невозможности деле- 
ния. 


Код программы приведен в листинге 3.4. 


Листинг 3.4. Калькулятор 


пе" 5, * Калькулятор Чу" 10) 
рг11п% ("Для выхода введите а в качестве знака операции“) 
\р11е Тгие: 

5 = заре (Знаю; (н=:“,/): м) 

1Е $ == 'а': БгеаКк 


2. рукой о Глава 3. Операторы 


Е 5 1 (И -ет, те, ЖЖ, ув 
х = Ноа (1пра® ("х=")) 
у = Поа® (1приф ("у=")) 


А 
рЕзпе ("%.2Е" % (х+у)) 
ВАЗЕ в == М 
РЕЗ ("%. 22" № (У) 
ей 5 == \*: 
Рита ("% 2" 8: (5) ) 
а Е ВЕСИ 
уве 0% 
РЕВаЕ ("5 А" У) 
е1зе: 


рг1пЕ ("Деление на ноль!") 
е]1зе: 
рг1пё ("Неверный знак операции!") 


Посмотрим на вывод программы. Обратите внимание, как она реагирует на 
неверный ввод, например, если введено число вместо знака операции, или 
был введен 0 вместо у при делении: 


хххххххкхххкхжкхкх Калькулятор ххххххжхкхх 


Для выхода введите а в качестве знака операции 
Знак (+,-,*,/): + 
х=]2 

у=13 

29.400 

Знак: у -.ДОЯ 
х=100 

у=25 

75-00 

Знак ба 
х=9 

у=З 

3.00 

Знак (+,-,*,/): / 
х=9 

у=0 

Деление на ноль! 
Знак (+,-,*,/): \ 
Неверный знак операции! 
знак (+=, * 
х=1.25 

у=4 
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5.00 
Знак ии а 
>>> 


ГЛАВА 4. 


ЦИКЛЫ И УСЛОВНЫЕ 
ОПЕРАТОРЫ 


РуУпоп. Полное руководство 


4.1. Условные операторы 


4.1.1. ЛОГИЧЕСКИЕ ЗНАЧЕНИЯ 


В любой программе (если не считать самых простых) встречаются услов- 
ные операторы. Данные операторы позволяют выполнить отдельный 
участок программы (или наоборот, не выполнить) в зависимости от значе- 
ния логического выражения. Логические выражения могут вернуть только 
два значения: ие (истина) или Рае (ложь), которые ведут себя как числа 
1 и 0 соответственно. 


Логическое значение можно хранить в переменной: 


>>> а = Тгае; Б = Еа1зе; 
>>> а, Ь 
(Тгое, РЕа1зе) 


Логическим значением ие может интерпретироваться любой объект, не 
равный 0, не пустой. Числа, равные 0 или пустые объекты, интерпретиру- 
ются как Ра[бе. 
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4.1.2. ОПЕРАТОРЫ СРАВНЕНИЯ 


В логических выражениях Ру{оп используются следующие операторы 
сравнения: 


® == — равно; 

® |= — не равно; 

е < — меньше; 

е > больше; 

® <= — меньше или равно; 
® >= — больше или равно; 


е Ш- проверяет вхождение элемента в последовательность, возвращает 
Трие, если элемент встречается в последовательности; 


» 1$ — проверяет, ссылаются ли две переменные на один и тот же объект. 
Если переменные ссылаются на один и тот же объект в памяти, оператор 
возвращает Те. 


Внимание! Условные операторы в Ру{оп могут сравнивать не 
только числа, но и строки, например аид! < Ытми, поскольку аид! 
находится по алфавиту раньше, чем Бтм. Но не все в Рупоп 
можно сравнить. Объекты разных типов, для которых не опре- 
делено отношение порядка, нельзя сравнить с помощью опе- 
раторов <, <=, >, >=. Например, вы не можете сравнить число 
и строку. Если вы попытаетесь это сделать, получите огромное 
сообщение об ошибке. 


Примеры (обратите внимание на возвращаемые значения П’ие и Еабе): 


Еа1зе 

>>> 100 > 99 
Тгае 

>>> 100 < 99 
Еа1зе 

>>> 100 <= 100 
Тгие 
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>>> 100 >= 101 
Ра1зе 

рэ: 2 Ш 2, 3 
Тгоце 

>>> а = = 100 
>>> а 13 Ь 

Тгае 

>>> 


Значение логического выражения можно инвертировать с помощью опера- 
тора поё: 


>>> а =Ь = 100 
>>> поЕ (а == 100) 
Ра1зе 


Если нужно инвертировать значение оператора т, оператор по нужно ука- 
зывать непосредственно перед #1 — без скобок: 


>>> м пов аи М 5, 7] 
Тгие 


При необходимости инвертирования оператора 1$, оператор по указывает- 
ся после этого оператора: 


>>> а 13$ поЕ Ь 
Еа1зе 


При необходимости, можно указывать несколько условий сразу: 


>> < 536 
Тгие 


С помощью операторов ап4 (И) и ог (ИЛИ) можно объединить несколько 
логических выражений: 


х апа у 
© ог у 


В первом случае, если х = Газе, то будет возвращен х, в противном случае 
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>>> 2 < бапа 2 < 6 
Тгие 

>>> 2 < 5 апа 6 < 2 
Еа1зе 


Во втором случае если х = Еа[зе, то возвращается у, в противном случае - х: 


>>> < 5 зб 
Тгое 
>>> 2 < 506 <2 
Тгое 
35 2 < 10 бб < 
Еа1зе 


Далее перечислены операторы сравнения в порядке убывания приоритета: 


1. <, >, <=, >=, ==, | =, <>, 15, 15 по, ш, по т 
2. по — логическое отрицание 
3. ап4 — логическое И 


4. ог — логическое ИЛИ 


4.1.3. ОПЕРАТОР ГЕ. .ЕЁЗЕ 


Оператор #/..ебе называется оператором ветвления. Он, в зависимости от 
значения логического выражения, может выполнить или, наоборот, не вы- 
полнить какой-то участок программы. Формат этого оператора следующий: 


1Е <логическое выражение>: 

<операторы, которые будут выполнены, если условие истинно> 
[е11Е <логическое выражение>: 

<операторы, которые будут выполнены, если условие истинно» 


] 
[е1зе: 
<операторы, которые будут выполнены, если условие истинно> 


Напомню, что блоки в составной конструкции выделяются одинаковым ко- 
личеством пробелов. Конец блока — инструкция, перед которой расположе- 
но меньшее число пробелов. 


Рассмотрим небольшой пример. Сейчас мы напишем программу, которая 
будет запрашивать число М у пользователя. Далее, программа проверяет 


РУПоп. Полное руководство ОО а, ру{Поп 


введенное значение -— оно больше или меньше ста - и выводит соответству- 
ющее сообщение (листинг 4.1). 


Листинг 4.1. Пример использования оператора #Й..е|5е 


п = 1106 (1приё ("Введите №: ")); 
ТЕ: ть < 7100: 

рг1пё ("п < 100") 
е1зе: 

РЕП ("а > 100") 


Введите М: 5 

п < 100 

>>> 

ЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕ======= ВБЗТАВТ: С:\бепр\ру\1Ё.ру ========================== 
Введите М: 567 

п > 100 

>>> | 


Рис. 4.1. Результат выполнения листинга 4.1 


У нас очень простая программа, в которой каждый блок состоит из одной 
инструкции, поэтому ее можно переписать так, как показано в листинге 4.2. 


Листинг 4.2. Пример использования оператора #Н..ейзе - 2 


п = 116 (1пру® ("Введите М: ")); 
Е п. < 100% реле Са < 100") 
е1зе: рг1пё ("п > 100") 


Однако не нужно злоупотреблять этим подходом. На практике лучше ис- 
пользовать подход, представленный в листинге 4.1. Так ваша программа 
будет более читабельной. 


Оператор 1/ .. ебе позволяет указывать несколько условий с помощью бло- 
ков её. Пример использования такого условного оператора приведен в ли- 
стинге 4.3. 


Листинг 4.3. Проверка нескольких условий 


рг1п® ("""Выберите ваш браузер: 
1 - Соод1е Сикопе 
2 - Е1геЕох 


2. рутпоп Глава 4. Циклы и условные операторы 


3 - М5 ТпеегпеЕ Ехр1огег 
4 - Орега 

5 - баЁаг1 

6 я Другой иии ) г 

Бгомзек = 106 (1праё("")); 
1Е Бгкомзегк == 1: 


рг1пе ("СЬгоще"); 
е11Е ргомзек == 
рке1пе ("Е1геЕох"); 


е11Е Бгомзегк == 3; 
РЕТОЕ ("М ТЕ"); 
е11Е Бгомзег == 4: 


рг1п® ("Орегка"); 
е11Е Бгомзек == 5 

ВЕ1ае ("Завахт").; 
е11Е Бгомзег == 6 
рг1п® ("Орех"); 


ЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕ ВЕСТАВТ: С:\Ееюр\ру\4=4.ру "ЕЕ енеЕченЕныЕ 


и. 


6 
ы 
8 
9 


Все. 
>>> 


Рис. 4.2. Результат работы программы из листинга 4.3 


Недостаток нашей программы - то, что она никак не реагирует, если поль- 
зователь введет число, отличное от 1 до 6. Исправить это можно с помощью 
еще одного блока е[$е: 


1Е Бкомзег == 1: 
рг1п® ("СВгопе"); 

е11Е Бгомзек == 

релпЕ(“Еткеох"); 


е11Ё Бхгомзек == 3: 
БЕШОе ("Мб ТВ“); 
е11Е Бгомзек == 4: 


рг1п ("Орега"); 
е11Е ргомзек == 
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рг1пЕ ("баЁаг1"); 


е11Е Бгомзегк == 6: 
рг1пё ("Другой"); 
е15е: 


рг1п® ("Неправильное значение") 
Не забывайте указывать блок ее, если нужна реакция на неопределенное 
в блоках е{{ значение. 


Примечание. Если вы программировали на других языках, то 
вам наверняка знаком оператор $\МИсН..сазе. Смысл этого опе- 
ратора в следующем: в змЙсп задается выражение, значение ко- 
торого сравнивается со значениями, заданными в блоках сазе. 
Если значение совпало, то выполняются операторы, указанные 
в этом блоке сазе. К сожалению, в Руоп нет такого операто- 
ра, и вам придется строить конструкции #..ей..е!е. Некоторые 
программисты предлагают использовать словари вместо $\М/Йсн.. 
сазе, но данный подход не универсальный и подойдет далеко не 
всегда. 


4.1.4. БЛОКИ КОДА И ОТСТУПЫ 
Рассмотрим следующий условный оператор: 


1Е аче < 18: 
рг1пе ("Извините, вы не можете использовать эту программу!" ) 


Обратитевнимание, что вторая строка написана сотступом. Отступ превра- 
щает наш код в блок. Блок - это одна или несколько идущих подряд строк с 
одинаковым отступом. Блок -— единая конструкция. 


Блоки используются, когда в случае выполнения условия нужно выпол- 
нить несколько операторов: 


1Е аае < 18: 
рг1п® ("Извините, вы не можете использовать эту программу!") 
рг1пе ("Как только исполнится 18, возвращайтесь!" ) 


На другом языке программирования блоки кода, как правило, заключают в 
фигурные скобки: 
Е (баде <.18) 1 


есво " Извините, вы не можете использовать эту программу!"; 
есво " Как только исполнится 18, возвращайтесь!"; 
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В других языках программирования в скобках какие-либо отступы соблю- 
дать не нужно, операторы разделяются точкой с запятой, а написать вы мо- 
жете их хоть в одну строчку, лишь бы они были в одних фигурных скобках. 


В РуФоп программисту нужно следить за отступами. Но с другой стороны 
это приучает его к порядку и делает код удобным для чтения. 


4.2. Циклы 


Если проанализировать все программы, то на втором месте, после условно- 


го оператора, будут операторы цикла. Используя цикл, вы можете повто- 
рить операторы, находящиеся в теле цикла. Количество повторов зависит 
от типа цикла — можно даже создать бесконечный цикл. В этом и есть неко- 
торая опасность циклов - если не предусмотреть условие выхода из цикла, 
то может произойти зацикливание программы, когда тело цикла будет вы- 
полняться постоянно. 


4.2.1. ЦИКЛ РОВ 


Цикл юг в других языка называют еще циклом со счетчиком, поскольку он 
позволяет повторить тело цикла (инструкции внутри цикла) определенное 
количество раз. В Руфоп цикл г больше похож на цикл югеасВ языка 
РНР - он позволяет перебрать элементы последовательности. 


Формат цикла Фг следующий: 


Еог <элемент> 1п <последовательность> 

<тело цикла> 
[е1 зе: 

<блок, который будет выполнен, если не использовался 
оператор Бгеак> 


] 
Здесь элемент — это переменная, через которую будет доступен текущий 


элемент итерации. Последовательность — объект, поддерживающий меха- 
низм итерации -— строка, список, кортеж, словарь и т.д. Тело цикла — опера- 
торы, которые будут выполняться при каждой итерации цикла. 


Изюминка цикла юг в языке Ру{Поп -— наличие блока е[$е, который задает 
операторы, которые будут выполнены, если внутри цикла не использовался 


Рупоп. Полное руководство ООО в: ру%Воп 


оператор ЮгеаК. Данный блок не является обязательным, но вы можете его 
использовать в контексте, показанном в листинге 4.4. 


Листинг 4.4. Пример использования блока е/5е в цикле Гог 


Бог 1 1п гапде(1, 10): 
рг1пе (1) 

е1зе: 
рг1пЕ ("Все.") 


Результат выполнения этого кода приведен на рис. 4.3. Как видите, сцена- 
рий вывел числа от 1 до 9 и в конце работы цикла вывел сообщение "Все." 
Теперь переделаем цикл так, чтобы внутри был оператор БгеаК, который 
прерывает работу цикла (лист. 4.5). Результат изображен на рис. 4.4. Как 
видите, если выполнение цикла прерывается оператором БгеакК, то операто- 
ры из блока е[$е не выполняются. 


ВЕЗТАВТ: С: \Еетр\ру\4-4.ру ============ 


1 
2 
Е] 
4 
5 
6 
7 
8 
9 


[* =) 
[®] 
[4 


Рис. 4.3. Результат выполнения кода из листинга 4.4 


ВЕСТАВТ: С: \сепр\ру\4-5 ‚ру = 


умиъьюн- 


Рис. 4.4. Результат выполнения кода из листинга 4.5 
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Листинг 4.5. Цикл с оператором Бгеак 


Еог 1 1п гапае(1, 10): 
"рЕШПЕ (1) 
1Е 1 == 
ргеак 
е15е: 
рг1п® ("Все.") 


Блок ее не обязателен и вы можете его не использовать. 


Цикл г можно также использовать для перебора элементов словаря, хотя 
словарь не является последовательностью. В листинге 4.6 приведен пример 
перебора элементов словаря. 


Листинг 4.6. Пример перебора элементов словаря 


Чо а Зи п 22 
Еог Кеу 11 а1се.кКеуз (): 
рг1п* (Кеу, " => ", а1сЕ[Кеу]) 


Рис. 4.5. Перебор элементов словаря 


Наверное, вы заметили, что элементы словаря выведены в произвольном 
порядке, а не в том, который был указан при создании объекта. Чтобы упо- 
рядочить вывод словаря, его ключ нужно отсортировать функцией зое(): 


Еог Кеу 1п зог%еа (41се.Кеуз ()): 
рг1пе (Кеу, " => ", а1сЕ[кеу]) 


После этого ВЫВОД будет такой, как вы ожидали: 
с: \РубВоп3З9>руЕВоп асе .ру 

2 =>. 1 

Ь => 2 


Цикл фог можно использовать не только для прохода по последовательно- 


сти чисел. Возможен проход по любой последовательности элементов. На- 
пример, вот так можно пройтись по всем буквам: 


Рупоп. Полное руководство г. руЕВоп 


Еог 1ебфег 1п мога: 
рг1пе (1еефехг) 


4.2.2. ЦИКЛ МНШЕ 


В языке Ру!фоп кроме цикла Фог есть также и цикл \ВЙе. На этот раз дан- 


ный цикл — без сюрпризов и он работает так, как в других языках програм- 
мирования, а именно выполняется до тех пор, пока логическое выражение 
истинно: 


мВ11е <логическое выражение>: 

<тело цикла> 
[е15е: 

<блок, который будет выполнен, если не использовался 
оператор БгеаКкК> 


] 


Как и у цикла юг, у цикла \ВШе есть блок ебе. Оператор \%Ве нужно ис- 
пользовать очень осторожно. Если в теле цикла не предусмотреть изме- 
нение логического выражения, то можно получить бесконечный цикл, 
который приведет к так называемому "зацикливанию" программы. Ниже 
приведено несколько примеров "вечных" циклов: 


# Условие неизменно и всегда истинно. 
мр11е Тхкие: 
рг1п% ("Привет") 


# В теле цикла значение п не изменяется, следовательно, 
# п всегда будет < 10 и цикл будет выполняться бесконечно 
п =0 
м611е п < 10 
рг1 п ("Привет") 


Прервать выполнение бесконечного цикла можно с помощью комбинации 
клавиш СУТ] - С, после чего вы увидите такой вывод: 


Тгасераск (мозф гесепе са11 1аз%) : 
Е1]е "<рузВе11#21>", 110е 2, 1п <моао1е> 
рг1пЕ ("Привет") 
Е11е "Е: \РуЕроп39\116\1а1е115\Ру5Бе11.ру", 11пе 1352, 11 икые 
гееогп зе1ЁЕ.56е11.мх1е(5, зе1Ё.$ад$) 
КеубоагаТпЕеггире 
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Цикл ог более безопасен — он будет закончен тогда, когда будут перебра- 
ны все элементы последовательности. Бесконечных последовательностей 
не бывает, поэтому рано или поздно цикл будет закончен (если, конечно, в 
цикле не происходит изменения последовательности). А вот за телом цикла 
зе нужно следить. Чтобы не допустить бесконечного цикла нужно или 
предусмотреть условие выхода из цикла или предусмотреть изменение ус- 
ловия. Перепишем два наших проблемных цикла так, чтобы они стали "ко- 
нечными": 


# Предусматриваем условие выхода 
# Тело будет выполнено 5 раз 
п=о0 
ир11е Тгие: 

рг1пЕ ("Привет") 

п += 1 

1Е п == 5: БгеаКк 


# В теле цикла значение п увеличивается, следовательно 
# как только оно достигнет 10, цикл будет прерван 
п =0 
ир11е п < 10 
рг1пЕ ("Привет") 
п += 1 


4.2.3. ОПЕРАТОРЫ ВВЕАК И СОМТМОЕ 


Как уже было показано ранее, оператор ФгеаК досрочно прерывает цикл. 
Оператор сопипие прерывает текущую итерацию и осуществляет переход 
на следующую. Пример использования этих операторов приведен в листин- 
ге 4.7. 


Листинг 4.7. Операторы БгеаК и сопипие 


Еог п 1п гапае(1, 20): 
ЗЕЕ И == 
соп1пие 
ЕЕ == 12: 
ЬгеаКк 
рг1пЕ (п) 


Хотя последовательность содержит числа от 1 до 19 (конечное значение не 
входит в возвращаемое значение), число 5 не будет выведено, поскольку 


Рупоп. Полное руководство а я 2; ручноп 


оператор сопёпие выполнит переход на следующую итерацию, а выполне- 
ние всего цикла будет прервано на 12-ой итерации. В итоге мы увидим чис- 
ла от 1 до 11, но без числа 5 (см. рис. 4.6). 


НЕ ===—===—==—== ВЕЗТАВТ: С: \&етр\ру\4-7.ру = 


Рис. 4.6. Операторы ьгеак и сопйпие (лист. 4.7) 


4.2.4. ФУНКЦИЯ ВАМСЕ() 


Функция тапре() позволяет сгенерировать последовательность нужной 


длины. По сути, функция тапре() позволяет превратить цикл #юг в его клас- 
сический вариант -— цикл со счетчиком, например: 


Еог х 1 гапае (1, 100): 
рг1 пе (х) 


Формат функции тапее() следующий: 


гапде ([начало,] конец [, шаг]) 


Если у функции один параметр, то это — конец. При этом в качестве па- 
раметра начало используется 0. То есть гапе(0) равносильно гапяе(0, 100). 
Значение параметра конец не включается в создаваемую последователь- 
ность, то есть при вызове гапёе(0, 100) в последовательности будут числа 
от 0 до 99. 


Параметр шаг задает инкремент. По умолчанию используется значение 1. 
Шаг может быть и отрицательным, поэтому вы можете не только увеличи- 
вать значение, но и уменьшать его: 


Еог х 1п гапае (200, 100, -1): 
рг1п (х) 
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В Руфоп 2 функция тапзе() возвращала просто список чисел. В Руоп 3 
возвращается объект, поддерживающий ‘механизм итерации. Данный объ- 
ект поддерживает методы ш4ех(<значение>) и соип(<значение>). Пер- 
вый возвращает индекс элемента, имеющего указанное значение. Второй 
возвращает количество элементов с указанным значением. Примеры: 

>>> гпд = гапае(1, 100) 

>>> гпа.1таех (5) 

4 

>>> гпа.соипе (100) 

0 


Нумерация элементов начинается с 0, поэтому элементу с числом 5 соот- 
ветствует индекс 4. А вот поскольку число 100 не входит в.нашу последова- 
тельность, то количество элементов, равных 100, равно 0. 
Рассмотрим еще несколько примеров использования гапбе(): 
Еог 1 1п гапае (10): 

рг1пе (1, епа=" ") 


рг1пЕ () 


Еог 1 1п гапае(0, 50, 5): 
рг1пе (1, епа=" ") 


рг1пЕ () 


Еог 1 1п гапае(10, 0, -1): 
рх1пе (1, епа=" ") 


Вывод будет таким: 


0123456789 
0 5 10 15 20 25 30 35 :40` 45 
О.о веет 6 эОеЗ2:л 


Первый цикл фог выводит значения от 0 до 10. Мы указываем только верх- 
нюю границу. Если нижняя граница не указана, то подразумевается, что это 
0. 


Второй цикл фог работает от 0 до 5, а увеличение счетчика происходит сразу 
на 5 единиц. Поэтому мы увидим числа 0, 5, 10, 15 и т.д. - кратные 5. 


Третий цикл работает от 10 до 0, уменьшение счетчика происходит на еди- 
ницу (-1). Поэтому числа будут выведены в обратном порядке. 


РУоп. Полное руководстто МО ©; руспоп 


Функция тапве() возвращает последовательность цифр. Если ей передать в 
качестве аргумента положительное число, то последовательность будет ох- 
ватывать числа от (0 до переданного аргумента (включая его). 


Если передать функции тапее() три аргумента, как мы это сделали во вто- 
ром и третьем случаях, то они будут рассматриваться как начало, конец 
счета и интервал. Начало — это первый элемент нашей последовательности 
чисел, а конечное значение в него не попадает, поэтому мы получили набор 
чисел о 5 10 15 20 25 30 35 40 45 во втором случае. 


4.3. Бесконечные циклы 


4.3.1. БЕСКОНЕЧНЫЙ ЦИКЛ ПО ОШИБКЕ 


Особое внимание уделите изменению значения управляющей переменной. 
Неправильно составленное условие может привести к бесконечному циклу. 
Рассмотрим пример зацикливания программы: 


К = 10 

уй11е к > 5: 
рг1пе (К) 
кК=К+1 


Здесь цикл будет выполняться, пока К больше 5. Изначально Ку нас больше 
5, далее значение К только увеличивается, поэтому мы получим бесконеч- 
ный цикл — программа будет бесконечно увеличивать значение К и выво- 
дить его: 


388 
389 
390 
39 
392 
393 
394 
95 
396 
397 
398 
399 
400 
401 
402 
403 
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Прервать выполнение зацикленной программы можно с помощью комби- 
нации клавиш СН] + С: 


ТгасеБаск (мозЕ гесеп® са11 1а$®): 
Е11е "Е: /РуЕроп39/1оор.ру", 11пе 3, 1п <моаи1е> 
рг1пЕ (К) 
Е11е "Е: \Рурор39\116\191е115\Ру5ре11.ру", 110е 1344, 1п 
м1 фе 
гебогп зе1ЁЕ.5$6е11.имг16е(5з, зе1Ё.$адз) 
КеуБоагаТпфеггире 
>>> 


Как исправить бесконечный ЦИКЛ. Здесь нужно или редактировать условие 
или, же процесс изменения значения управляющей переменной. Например, 
можно сделать декремент управляющей переменной: 


К = Кя 


Тогда программа выведет 5 чисел и завершит свою работу: 


10 
9 


8 
7 
6 
Если разложить наш цикл на итерации, то получится табличка, приведен- 


ная ниже (табл. 4.1) 


Таблица 4.1. Итерации цикла 


Проверка 
условия 


Номер итерации Значение А 


Действия 


рг1пе (К) # 10 


3 8 (гие 
4 7 (гие 

рг1пе (К) #6 
5 6 (гие 

ЕЕ К-т1т#5 
6 5 {а5е - 


Можно было бы изменить и условие, например: 


К = 10 

\Б11е К < 15: 
ре1пЕ (К) 
к=К+1 


Тогда программа выведет: 


10 
т 
2 
13 
14 


Типичная ошибка новичков — многие вообще забывают изменять перемен- 
ную в цикле. Например: 


# Внимание! Код содержит ошибку! 
к 
мр11е К <= 10: 

ре1пЕ (К) 


Очевидно, программист хотел, чтобы программа отобразила числа от 1 до 
10, но забыл изменить значение К в теле цикла. Следовательно, программа 
будет выполняться бесконечно. 


Подытожим. Чтобы не ПОЛУЧИТЬ бесконечный ЦИКЛ, необходимо: 


1. Следить за начальным значением управляющей переменной 


2. Проанализировать условие выхода из цикла 
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3. Следить за процессом изменения значения управляющей переменной: 
ей должны присваиваться такие значения, которые рано или поздно при- 
ведут к выходу из цикла 


4.3.2. НАМЕРЕННЫЙ БЕСКОНЕЧНЫЙ ЦИКЛ 


Ради справедливости нужно отметить, что иногда бесконечные циклы соз- 
даются преднамеренно, поскольку того требуют условия задачи. Например, 
мы пишем какую-то программу, которая обрабатывает запросы извне, 
например, поступающие по сетевому сокету. 


В этом случае проще написать так: 


мр1]е Ткие: 
блок кода 


Ненужно использовать пример, приведенный ранее (когда значение управ- 
ляющей переменной не установлено) - так ваш код будет похож на ошибоч- 
ный. А когда вы указываете ме Тгие:, то вы явно сообщаете, что хотите 
создать бесконечный цикл. 


Как все-таки прервать цикл, например, если в теле цикла было получено 
сообщение прекратить работу программы? Для этого нужно использовать 
инструкцию ‚геаК. Например: 


мр11е Тгие: 
Чафа = геаа_Егоп_зоске® () 
1Е аафа == "аи1%": 
Бгеак 


Вы обязательно должны предусмотреть возможность выхода из бесконеч- 
ного цикла. В данном случае, если значение переменной Дака будет равно 
"1", то выполнение цикла будет прервано. 


Нужно обязательно предусмотреть возможность выхода из цикла, по- 
скольку прерывание цикла по нажатию СИ] + С, во-первых, считается дур- 
ным тоном, во-вторых, приводит к прерыванию всей программы, а не 
только цикла. 


Как и в других языках программирования, в Ру оп есть инструкция 
сопйпие, позволяющая пропустить итерацию. Например: 


к=о0 
м111е К < 17: 
К=К+т1 
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ВЕ К 55 == 0 
сопё1пое 
рг1п® (К) 


Программа выведет: 


юючмьшь вн 


о > + 
чаъююн 


Как видите, в списке отсутствуют значения, кратные 5. Если остаток от де- 
ления на 5 равен 0, то мы просто переходим на следующую итерацию и про- 
пускаем текущую. В этом коде, не смотря на его простоту, очень сложно до- 
пустить ошибку. Например, если изменять значение К уже после проверки 
на кратность оператором №, то можно получить бесконечный цикл: 


# Внимание! Код содержит ошибку! 


К = 0 
\В11е К < 17: 
ЧЕ К $%5 == 0: 
сопЕ1тпие 
рг1пе (К) 
К=К+1 


Давайте посмотрим, что произойдет. Представим, что К уже равно 4. 
Поскольку К < 17, начнется выполнения тела цикла. Так как К % 5 не равно 
0, инструкция сопипие не будет выполнена. Цифра 4 будет выведена на 
экран, после чего значение К будет увеличено на 1 и станет равно 5. 


Далее проверяется условие: значение К < 17, поэтому начинается выполне- 
ние тела цикла. В результате К % 5 мы получаем 0 и пропускаем текущую 
итерацию. Но проблема в том, что значение К мы так и не увеличили, и оно 
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по-прежнему равно 5. Ситуация повторяется, и так будет происходить, пока 
вы не нажмете Са] + С. 


4.4. 


стинные и ложные значения 


Рассмотрим вот такое условие: 

1Е эзсоге: 

Странно, ведь $соге не сравнивается ни с одним значением, как так? Сама 
переменная $соге выступает как условие. Если значение $соге будет равно 


0, то это считается ложным значением (/а/5е). Любое другое значение счита- 
ется истинным (Ё7ие). С тем же успехом мы могли бы написать: 


Е зсохе > 0» 


Но незачем делать код сложнее! Ведь можно сделать его проще! 


4.5. Практический пример. 
Программа Уровень доступа 


Логические операторы поЕ оги ап4 представляют логические операции 


НЕ, ИЛИ и И соответственно. 


Логическая бинарная операция И (ап@) возвращает йе, если оба операнда 
истинны: 


1Е мопеу апа зсоге: 


Здесь подразумевается, если деньги и счет отличны от 0, то условие будет 
ИСТИННЫМ. 


Логическая бинарная операция ИЛИ (ог) возвращает тие, если один из 
операндов равен тие: 


1Е попеу ог зсоге: 


Если одна из переменных, содержит значение, отличное от 0, то условие бу- 
дет истинным. 


Рупоп. Полное руководство Я 


Логическая унарная операция отрицания МОТ возвращает истину, если 
операнд был ложным и наоборот. Вот как можно бесконечно запрашивать 
ввод пароля, пока он не будет введен: 


раззмока = "" 
\м511е поЕ раззмога: 
раззмога = 1пра® ("Пароль: ") 


Данные логические операции можно использовать для составления более 
сложных условий в циклах и условных операторах 1. Рассмотрим неболь- 
шой пример (лист. 4.8). Данная программа запрашивает логин и пароль и 
на основании этих данных определяет уровень доступа. 


Листинг 4.8. Определение уровня доступа 
1еуе1 = 0 # Уровень доступа 
Тодап =" 
\мр11е поЕ 1оа1п: 
1о91п = 1пра® ("Логин: ") 


раззмога = "" 
\мр11е пое раззмога: 
раззмога = 1пра® ("Пароль: ") 


1Е 1о0о91п == "гоо®" ап раззмога == "123"; 
1еуе1 = 10 
е11Ё 1о91п == "щагК" ап раззмога == "321"; 
1еуе? = 5 
1Е 1еуе1: 
рг1пе ("Привет, ", 10411) 
рг1пе ("Ваш уровень доступа: ", 1еуе1) 
е15е: 


рг1пе ("Доступ запрещен!") 


По умолчанию уровень доступа равен 0. Если это так, то доступ закрыт. 
Если уровень отличается от 0, то программа выводит приветствие и сооб- 
щает уровень доступа. 


Сначала мы в двух циклах Ве запрашиваем логин и пароль. Благодаря 
наличию поё мы будем запрашивать логин и пароль до тех пор, пока они не 
будут введены. 
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Далее мы сравниванием введенные значения с определенными констан- 
тами и определяем уровень доступа. 


Рассмотрим вывод программы: 


Логин: щагк 

Пароль: 321 

Привет, магКк 

Ваш уровень доступа: 5 
>>> 


Логин: гоо®е 
Пароль: 1234 
Доступ запрещен! 
>>> 


В первом случае были введены правильные логин и пароль. Программа 
сообщила уровень доступа. Во втором случае логин был введен правильно, 
а пароль - нет. Программа сообщила, что доступ закрыт. 


ГЛАВА 5. 


МАТЕМАТИЧЕСКИ 
ФУНКЦИИ 


РУПоп. Полное руководстто Мм 2 рутпоп 


5.1. Поддерживаемые типы чисел 


Ру {оп поддерживает следующие типы чисел: 1пё, Ноа, сотр/ех. Как вы уже 
знаете из предыдущих глав, это целые, вещественные и комплексные числа 
соответственно. При операции с числами нужно помнить, что результатом 
операции является число более сложного типа. Например, вы хотите умно- 
жить целое число на вещественное, тогда результатом будет вещественное 
число. 


Самым простым числовым типом является целое число. Чуть сложнее 
— вещественное, поскольку у него есть дробная часть. Конечно же, самым 
сложным типом является комплексное число. 


Создать числовой объект можно так же, как и объекты остальных типов: 
>>> а= 5; р=2 


> е=а*ьБ 


С помощью префиксов 0Ь (0В), 0о (00) и 0х (или ОХ) можно указать числа 
в двоичной, восьмеричной и шестнадцатеричной системах счисления соот- 
ветственно: 
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>>> а = 0511110000 
>>> р = 00555 
>>> с = ОхНЕ 


Вещественные числа могут быть представлены в экспоненциальной форме 


— с точкой и буквой Е, например: 


>>> а = 5е10 
>>> Ь = 2.5е-5 


Вещественные числа записываются в виде: 


Вещественная_ часть +мнимая_частьФ 


Например: 


>>> а = 3+44 


Для выполнения операций повышенной точности над вещественными чис- 
лами нужно использовать модуль 4есипа], например: 


>>> Егом Ааес1та1 цирог® Пес1ма1 
>>> Бес1та1 ("0.2") - Пес1мта1 ("0.1") - Пес1ма1 ("0.1") 
Рес1та1 ('0.0') 


Модуль Ресита] реализует "Общую спецификацию десятичной арифмети- 
ки" ВМ. Само собой, разумеется, есть огромное число параметров кон- 
фигурации, которые выходят за рамки этой книги. 


Новички в Ру!фоп могут использовать модуль Ресипа], чтобы избежать 
проблем с точностью, которые имеются при работе с типом данных Йоай. 
Однако здесь важно понять, а нужна ли вам такая точность. Тут все зависит 
от вашего приложения. Если вы решаете научные или технические задачи, 
занимаетесь компьютерной графикой или решаете большинство задач на- 
учной природы, вам будет вполне достаточно обычного типа Йоа®. В мире 
существует очень мало вещей, для которых будет недостаточно обеспечива- 
емой этим типом данных 17-значной точности. Таким образом, крошечные 
ошибки, имеющиеся в вычислениях, просто не имеют значения. К тому же 
производительность вычислений с типом данных Йоаё (в отличие от моду- 
ля Оесипа|) — на высоте. 
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Исходя из всего сказанного, основное применение модуля 4есйта! — в 
финансовых программах. В таких программах необходимо чрезвычайно 
точное вычисление и даже малейшие ошибки недопустимы. Таким образом, 
есипа| позволяет избежать таких ошибок. Также объекты 4есипа| принято 
использовать при взаимодействии с базами данных, особенно при доступе 
к финансовым данным. 


Модуль гасйоп$ обеспечивает поддержку рациональных чисел: 


>>> Егом Егас®1опз 1птроге Егас®1оп 
25: Егаеецоп("0. 2"). - ЕкасЕко ("0.1") - ЕвАасетой ("0.1") 
Егас®1оп (0, 1) 


Модуль #гасйоп$ может быть использован для осуществления математиче- 
ских операций с дробями. Например: 


>>> Егом Егас®1опз 1прог® Егас®1оп 
>>> а = Егасе1оп (6, 4) 

>>> р = Егас&1оп (7, 12) 

>>> ре1ПпЕ (а + Ю) 

РО 

>>> рг1пЕ (а * Б) 

7/8 


>>> # Получение числителя/знаменателя 
2 ю=ат*ь 
>>> с.помега®огк 


>>> с.аепом1па®ог 
>>> # Конвертирование в Ноае 
>>> ПоаЕ (с) 


0.875 


>>> # Ограничение значения знаменателя 
>>>: реп (с.1111Е аепом1пабок (8) ) 


7/8 

>>> # Преобразование из Ноа в дробь 
>>> х = 5.75 

>>> у = РГгасЕ1оп (*х.аз 1п6едекг га®1о()) 
22:9 


Егас®1опт (23, 4) 
>>> 
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5.2. Числовые функции 


В таблице 5.1 представлены встроенные числовые функции, имеющиеся в 
Руфоп. 


Таблица 5.1. Встроенные числовые функции 


Описание 


Возвращает абсолютное значение числа: 


аз (<число>) 55 НЗ (5), ЗВ 8 


(5 15 
Преобразует десятичное число в двоичную си- 
стему, возвращает строку: 


>>> Ь1п(0), Ь1п (333) 
{"0Б0".„ “ОБО Он”) 


Ып(<число>) 


Возвращает кортеж из двух значений - (а //Ь, 


Футод(а, Б) а%Б) 


Преобразует целое число или строку в веще- 
ственное число: 


Яоа((<число или строка>) |>>> поа+ (3), Ноае ("2.2"), 
Поа* ("13.") 
(3..0; ды 1353 


Преобразует десятичное число в шестнадцате- 


Цихоечисло>) ричную форму, возвращает строку 


Преобразует объект в целое число. Второй па- 
раметр позволяет указать систему счисления: 


16 — шестнадцатеричная 


10 — десятичная (по умолчанию) 


п6(<объект> [, система | 8 - восьмеричная 


счисления] ) 


2 - двоичная 


Пример: 


ое ПЕ), 10 ("50,; 10, 
тие (С“оОхнЕ“, 16), тие (“00555 , 8) 
(5,50, 4095, 365) 
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Возвращают максимальное/минимальное зна- 
чение из заданного списка. Список задается 


тах(<список>) 
через запятую: 
пип(<список> 
(<еп ) >>> аа, 7, 5), ны, 4, 9 
(7, 1) 
Преобразует десятичное число в восьмерич- 
осё(<число>) а р 


ную систему, возвращает строку 


Возводит указанное число в указанную сте- 
пень. Последний параметр задает остаток от 
деления, то есть если он указан, то возвращает- 
ся остаток от деления (число возводится в сте- 
роу(<число>, <степень> [, | пень, делится. на Ки возвращается остаток). 
ку Например: 


>>> ром(5, 2), рои(10, 2, 
ром (10, 2, 3) 
(25, 0; № 


Округляет число до ближайшего меньшего 
целого для чисел с дробной частью меньше 0.5 
или до ближайшего большего целого для чи- 
сел с дробной частью больше 0.5. Если дробная 
часть равна 0.5, округление производится до 

гоипа (<число> [, М]) ближайшего четного числа. Второй необяза- 
тельный параметр М задает число знаков после 
точки. Пример: 


>>> гоппа (0.33), гкоппа (1.7), 
гоппа (0.51) 
(0, 2, 3) 


Возвращает сумму значений элементов после- 
довательности плюс М (М - это начальное зна- 
чение). Примеры: 


5ит( <последовательность> 


М 


>>> зит([1, 2, 3]), зам ([1, 2, 3], 
1) 
(6, 7) 
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Встроенные функции можно использовать без указания имени модуля, в 
котором они находятся. Одни из самых частых операций - округление и 
форматирование чисел. Обе эти операции и рассмотрены далее. 


5.2.1. ОКРУГЛЕНИЕ ЧИСЛОВЫХ ЗНАЧЕНИЙ 


Часто нужно округлить число с плавающей запятой к числу с фиксирован- 
ным числом десятичных знаков. Для простого округления можно исполь- 
зовать встроенную функцию гоип4(уаше, п41= 3). Например: 


>>> гоппа (1.24, 1) 

5-2 

>>> гоппа (1.28, 1) 

Теа 

>>> гоппа(-1.29, 1) 

#1. 3 

>>> гоппа(1.25371,3) 

1.254 

>>> 

Функция тоипа() округляет промежуточные значения к ближайшей четной 
цифре. То есть значения, такие как 1.5 или 2.5 будут округлены к 2. Число 
разрядов, передаваемых функции гоип4() может быть отрицательным, ког- 
да округление имеет место для десятков, сотен, тысяч и т.д. Например: 


>>> а = 2625531 
>>> гоипа(а, -1) 
2625530 

>>> гоппа(а, -2) 
2625500 

>>> гоппа(а, -3) 
2626000 

>>> 


Не путайте округление с форматированием значения для вывода. Если 


ваша цель заключается в том, чтобы просто вывести численное значение с 
определенным числом десятичных разрядов, вы не должны использовать 
тоипа(). Вместо этого лучше определить желаемую точность при формати- 
ровании. Например: 
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>>> х = 1.234567 

>>> Еогпае(х, '0.2Е') 

В 

>>> Еогтаа& (х, '0.3Е') 

12239" 

>>> 'попьег - {:0.3Е}'.Еогта& (х) 
‘попрегк - 1.235' 

>>> 


Кроме того, не нужно округлять числа с плавающей запятой к числам с 


фиксированным числом десятичных разрядов, чтобы избежать проблем 
точности. Пример: 


>>> а = 3.1 


>>> Ь = 4.2 
>>> с=а+Ь 
>>> с 


7.300000000000001 

>>> с = гоппа(с, 2) 

>>> с 

У =3 

>>> 

Для большинства приложений, работающих с плавающей точкой, просто 
рекомендуется это сделать. Если для вас важно предотвращение таких оши- 
бок (например, в финансовых приложениях), рассмотрите использование 
модуля 4есита|. 


5.2.2. ФОРМАТИРОВАНИЕ ЧИСЕЛ ДЛЯ ВЫВОДА 


Для форматирования одного числа для вывода, используется встроенная 
функция Югтас(). Например: 


>>> х = 9876. 54321 

>>> # Два десятичных места точности 

>>> Еогпа®(х, '0.2Е') 

'9876.54' 

>>> # Выравнивание по правому краю, 10 символов, 1 разряд 
точности 

>>> Еогпа®(х, '>10.1Е') 

у 9876.5" 

>>> # Выравнивание по левому краю, 1 разряд 
>>> Еогшае(х, '<10.1Е') 

'98:16...5 у 

>>> # Выравнивание по центру 
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>>> Еогма®(х, '^10.1Е') 

"ЭВ У 65 “ 

>>> # Добавление разделителя тысяч 
>>> Еонпа®(х, ',') 

'9,876.54321' 

>>> Еогвае(х, '0,.1Е') 

"9,876.55 

>>> 


Если вы хотите использовать экспоненциальную запись, измените Ё нае 


или Е, в зависимости от регистра, который вы хотите использовать для экс- 
поненциального спецификатора. Например: 


>>> Еогта®(х, 'е') 
'9.876543е+03' 

>>> Еогва*(х, '0.2Е') 
'9.88Е+03' 

>>> 


Общая форма ширины и точности в обоих случаях - '[<>^]?\а[,]?(. 
412165) ?', где мА (ширина) и 411$ (разряды) -— целые числа, а ? показы- 
вает дополнительные части. 


Форматирование значений с разделителем тысяч тоже не проблема. Одна- 
ко сам разделитель зависит от настроек локали, поэтому желательно иссле- 
довать функции из модуля [юса[е. Вы можете заменить символ разделителя, 
используя метод тапз{[аёе() строки. Например: 


>>> зерагафогз = { ог@('.'):',', ога(','):'.' } 
>>> Еогва*(х, ',').Егапз1афе (зерагафогз) 
а Е Я 

>>> 


5.3. Математические функции 


Математические функции содержатся в модуле та, поэтому перед их ис- 
пользованием вам нужно импортировать этот модуль: 


1прогЕ маеВ 
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Для работы с комплексными числами нужно импортировать модуль став: 


1трогЕ став 


В модуле та можно найти следующие константы: 
® р! — возвращает число Пи 


® е — возвращает значение константы е 


Пример: 


>>> 1ирогЕ май 
>>> маев.рл 
3.141592653589793 
>>> паёв.е 
2.718281828459045 


Математические функции приведены в таблице 5.2. 


Таблица 5.2. Математические функции (модуль тай) 


Функция Описание 

Аналогично абап(х/у). Если у равен 0, то возвращается 

абап2(х, у) : 
рИ/2 

сей(х) Возвращает наименьшее вещественное число с нулевой 
дробной частью — большее, чем число х 

ехр(х) Возвращает е**х 

газ (х) Возвращает абсолютное значение числа х 

Яоог(х) Наибольшее вещественное число с нулевой дробной ча- 
стью — меньшее, чем число х 

Ёто4(х, у) Возвращает остаток от деления х нау и эквивалентно х%у 

Ура У) Возвращает длину гипотенузы прямоугольника со сторо- 

жз нами длиной хиуи эквивалентно заг(х*х+у*у) 
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10=(х), [0=10(х) | Натуральный и десятичный логарифм числа х 


Возвращает кортеж из пары вещественных чисел -— дроб- 
ной и целой части х 


то4Ёх) 


зт(х), со$(х), | Всем известные стандартные и обратные тригонометри- 
(ап(х), азшт(х), | ческие функции (синус, косинус, тангенс, арксинус, арк- 
асо$(х), аап(х) | косинус, арктангенс). Значение возвращается в радианах 


зиай(х), 

со$П(х), Гиперболические синус, косинус, тангенс числа х 
таой(х) 

$агёСх) Корень квадратный числа х 


Поскольку функции неявляются встроенными, использовать их нужнотак: 


>>> 1прогЕ паВ 
>>> паёр.1о9 (10) 
2.302585092994046 
паев. 10910 (10) 

>>> пар. 10910 (10) 
1580 


5.4. Случайные числа. Модуль 
гапаот 


Модуль 7апдот() содержит функции для работы со случайными числами: 


1прогЕ гапаом 
Функции, предоставляемые этим модулем, приведены в таблице 5.3. 


Таблица 5.3. Функции для работы со случайными числами 


Возвращает случайное вещественное 


число г, находящееся в диапазоне 0.0 < 
г <1.0 
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М — это число от 0.0 до 1.0. Перемешива- 
ет элементы списка случайным образом. 
Функция работает непосредственно со 
списком и ничего нс возвращает, поэто- 
му будьте осторожны: лучше работать с 
копией списка. Если не указан второй 
параметр, то используется значенис, воз- 
вращаемое функцией гапЧотл() 


зи Йе( <список>|[, М]) 


Возвращает случайный элемент из ука- 
занной последовательности (которая 
может быть представлена списком или 
кортежем) 


сБолсе (<последовательность>) 


Возвращает случайное всщественное 
ипНогт(а, Ь) число г, находящееся в диапазоне а < г 


<Ь 


Возвращает случайное целое число г, 
гап4гапае(начало, конец, шаг) | находящееся в диапазоне гапбе (начало, 
конец, шаг) 


Примеры использования модуля гап4от: 


>>> тирогЕ гапаом 
>>> гапаом.гапаоп () 
0.9922129256765113 
>>> гапаом.ип1оки (1,100) 
64.5126755129645 
>>> гапагапае (1,100,1) 
ТгасерасКк (позе гесепЕ са11 1аз%): 

Е11е "<рузре11#26>", 11пе 1, 1п <поаи1е> 

гапакапае (1,100,1) 

МамеЕггог: паме 'гапЧАгапае' 1$ пое аейпеа 
>>> гапаойм.гапакапае (1,100,1) 
54 


Обратите внимание: если вызвать функцию без названия МОДУЛЯ, ТО ВЫ ПО- 


лучите сообщение об ошибке. Понимаю, что не очень хочется “таскать” за 
собой название модуля (пакета). Поэтому можете использовать конструк- 
ЦИЮ: 
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Его гапаом Шпрог® * 


После этого можно использовать функции как обычно: 


>>> гапЧом () 
0.9942452546319136 


Аналогично, вы можете импортировать все функции из ша и использо- 


вать их подобно встроенным функциям. 


Функция тапаот.сйосе() может использоваться для выбора случайного 
элемента последовательности: 


>>> пирог гапаом 
>>> зеа= (8; 7, 67 5, 34, З, 2, 
>>> гапаощм.сВо1се (зеа) 


>>> гапаом. сво1се (5еа) 


>>> гапаом. сво1се (5еа) 


Случайная выборка из М элементов с использованием тапдот.затрие(): 


>>> гапаош.затр1е (зеа, 3) 
[6, 7, 5] 
>>> гапаом.затр1е (зеа, 3) 
[2, 3, 4] 


Если вам нужно просто перемешать элементы последовательности, исполь- 
зуйте гапаот.5риДе(: 


>>> гапаом. зВайе (зеа) 
>>> зеа 
[5, 1, 6, 8, 3, 2, 4, 7] 


Чтобы создать случайные целые числа, используйте гапаот.тапатё(: 


>>> гапаош.гапа1пт* (0,100) 
47 
>>> гапаом.гапа1т® (0,100) 
97 


Модуль гап4от вычисляет случайные числа, используя алгоритм Вихря 
Мерсенна (Мегзеппе 'Ту1ет). Это — детерминированный алгоритм (то есть 
его не нужно предварительно инициализировать, как в РНР), но вы можете 
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настроить генератор случайных чисел на другую последовательность, ис- 
пользуя функцию тапаот.зееа(): 


гапаом . зееа () 
5.5. Значения тшЁпну и Мам 


В Руоп есть два специальных значения: 
е Ш бесконечность 


® МаМ (Мога МушБег) — не число 


У РуШоп нет специального синтаксиса для представления этих специаль- 
ных значений с плавающей запятой, но они могут быть созданы с помощью 
функции Лоа{(). Например: 


>>> а = Ноа+ ('1п=') 
>>> Ь Яоа+ ('-1п=') 
>>> с Яоа+ ('пап’) 
>>> а 

АЕ 

>>> Ь 

-1пЕ 

>>> с 

рап 

>>> 


Для проверки на присутствие таких значений используйте функции тай. 
т! О и тай лпап(). Например: 


>>> та&В.13з11пЕ(а) 
Тгое 

>>> тафН.1зпап (с) 
Тгие 

>>> 


5.6. Вычисления с большими 
числовыми массивами. Библиотека 
МитРу 
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Иногда появляется необходимость производить вычисления с огромны- 
ми наборами данных, представленными в виде массивов или таблиц. В 
РуШоп для этого принято использовать библиотеку МитРУ. 


Основное назначение МитРу - то, что она предоставляет объект массива, 
который более эффективен и лучше подходит для математических вычис- 
лений, чем стандартный список РуВоп. 


Рассмотрим простой пример, иллюстрирующий важные различия между 
массивами МитРу и списками: 


>>> # Списки РУ&Поп 

>>> х = [1, 2, 3, 4] 

>>> у = [5, 6, 7, 8] 

>>> х 2 

[1, 2, 3, 4, 1,2, 3, 4] 

>>> х-+ 10 

Тгасераск (позе гесепЕ са11 1аз®): 
Е1]е "<зЕа1п>", 11пе 1, 11 <поао1е> 

ТуреЕггог: сап оп1у сопсафепаее 11$ (поЕ "1п") Ео 11$Е 

>>> х+у 

[1, 2, 3, 4, 5, 6, 7, 8] 


+ 


>>> # Массивы Мапру 


>>> итрогЕ питру аз пр 

>>> ах = пр.агкгау ([1, 2, 3, 4]) 
>>> ау = пр.агкгау([5, 6, 7, 8]) 
>>> ах * 2 

аггау ([2, 4, 6, 8]) 

>>> ах + 10 

агкау ([11, 12, 13, 14]) 

>>> ах + ау 

аггау ( [ 6, 8, 10, 12]) 

>>> ах * ау 

агкау.(.[ 5, 12, 21, 321) 

>>> 


Как видите, основные математические операции с массивами ведут себя 
иначе. В частности, скалярные операции (например, ах * 2 илиах + 10) при- 
меняются к массиву поэлементно (в случае с обычным списком нужно было 
писать цикл и добавлять в цикле 10 к каждому значению списка). Кроме 
того, математически операции, когда оба операнда являются массивами, 
применяются к каждому элементу и в результате создается новый массив. 
Библиотека МитРу просто огромна и можно ей посвятить отдельную кни- 


гу. Посетите сайт Ййр://шшипитру.отЕ для дополнительной информации. 
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5.7. Программа "Угадай число" 


5.7.1. ПОСТАНОВКА ЗАДАЧИ 


Сейчас мы напишем программу "Угадай число", которая будет демонстри- 
ровать следующее: 


» Работу с генератором случайных чисел 
® Использование цикла \ВИе 


® Прерывание итерации 


Работа с циклами была рассмотрена ранее, а сейчас, так сказать, мы теорию 
закрепим практикой. 


Алгоритм работы будет такой: 


® В циклемы "загадываем" случайное число от 1 до 10 
® Затем просим пользователя отгадать это число 


® Если число правильное, мы выводим соответствующее сообщение и уве- 
личиваем значение переменной 5соге 


Также будет показано, как исправить логическую ошибку в программе. 


5.7.2. РАБОТА С ГЕНЕРАТОРОМ СЛУЧАЙНЫХ ЧИСЕЛ 


Для подключения генератора случайных чисел нужно импортировать мо- 
дуль гапдот: 


1прокгЕ гапаом 


Далее нужно вызвать функцию 7ап@тЕ(), передав ей начальное и конечное 
значение. Возвращенное случайное число будет лежать в диапазоне между 
НИМИ: 


гапаом .гапа1пт® (1, 10) 


В модуле гапдот также есть функция тапагапЕе(), возвращающая случай- 
ное целое число в промежутке от 0 до преданного в качестве параметра зна- 
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чения (но, не включая само значение), то есть вызов гап4гап2е(10) вернет 
числа от 0 до 9 включительно. 


Как по мне, то проще использовать таит), чем тапагапзе(). Но это смо- 
тря, что вам нужно. 


5.7.3. КОД ПРОГРАММЫ 


Код программы, действительно, очень прост (лист. 5.1). 


Листинг 5.1. Код программы "Угадай число" 


1трогЕ гапаом 
рг1пе({"*" * 10, "Угадай число", "*" * 10) 


рг1пЕ ("Компьютер выберет случайным образом число от 1 до 10. 
Попробуй угадать это число. Для выхода введите 0") 


апзиег = 1; 
зсоге = 0; 
1 = 0 


мр1]1е апзмег: 
1 
гапа = гапаом. гапа1п® (1, 10) 


апзмег = 1106 (1приё ("Введите число: ")) 
1Е апзмег == гапа: 

5соге = зсоге +1 

рг1п® ("Правильно! Ваш счет: ", зсоге, " из", 1) 
е15е: 


рг1пЕ ("Попробуйте еще раз!") 


рг1пе ("До встречи!") 


Программа ничего сверхъестественного не делает. В цикле \ВИе она про- 
веряет введенное пользователем значение. Если оно совпадает со сгене- 
рированным в начале итерации случайным значением, значит, выводится 
соответствующее сообщение и увеличивается значение переменной $соге. 
Параллельно мы ведем счетчик итераций, чтобы знать, сколько попыток со- 
вершил пользователь (переменная 1). 


Посмотрим на вывод программы: 


хххххххххх Угадай число ******ж*хжх 
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Компьютер выберет случайным образом число от 1 до 10. Попробуй 
угадать это число. Для выхода введите 0 

Введите число: 9 

Попробуйте еще раз! 

Введите число: 8 


Правильно! Ваш счет: 1 из 2 
Введите число: 5 
Правильно! Ваш счет: 2 из 3 


Введите число: 2 
Попробуйте еще раз! 
Введите число: 0 
Попробуйте еще раз! 
До встречи! 


5.7.4. ИСПРАВЛЕНИЕ ЛОГИЧЕСКОЙ ОШИБКИ В 
ПРОГРАММЕ 


Все бы хорошо, но в нашей программе есть одна логическая ошибка и как 
минимум одна недоработка. Для выхода пользователь должен ввести 0. Но 
посмотрите, что происходит при этом. 


Программа считает 0... еще одним вариантом, но никак не признаком вы- 
хода, поэтому она сообщает, что введенный вариант неправильный. Но он 
и не может быть правильным, поскольку случайные числа генерируются в 
диапазоне от 1 до 100. 


Исправить эту ошибку можно, если добавим конструкцию: 


1Е апзиегк == 0: 
ЬгеаКкК 


Данную инструкцию нужно добавить в самое начало тела цикла. Если поль- 
зователь введет 0, выполнение будет прервано. Также было бы неплохо, что- 
бы программа выводила статистику по окончанию игры: 


рг1пё ("Общий счет: ", зсоге, " из", 1) 
Измененный код приведен в листинге 5.2. 


Листинг 5.2. Окончательный вариант 


1прог®е гапаом 


рез ("*" * 10, "Угадай число", "*" * 10) 
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рг1пЕ ("Компьютер выберет случайным образом число от 1 до 10. 
Попробуй угадать это число. Для выхода введите 0") 


апзмег = 1; 
зсоге = 0; 
1=0 


\мр11е апзиег: 


гапЯ = гапаом. гапа1т® (1, 10) 
апзиег = 11% (1при® ("Введите число: ")) 
1Е апзмегк == 0: 
ргеаКк 
1Е апзмегк == .гапа: 
зсоге = зсоге +1 
ре1 пе ("Правильно!") 
е1зе: 


рг1п ("Попробуйте еще раз!") 
ев 


рг1пё ("Общий счет ", зсоге, " из", 1) 
рг1пе ("До встречи!") 


Вывод программы будет следующим: 


ххххжхххххх Угадай число ххжжхххжхкх 
Компьютер выберет случайным образом число от 1 до 10. Попробуй 
угадать это число. Для выхода введите 0 
Введите число: 7 

Попробуйте еще раз! 

Введите число: 5 

Попробуйте еще раз! 

Введите число: 4 

Попробуйте еще раз! 

Введите число: 0 

Общий счет 1 из 3 

До встречи! 


Вот теперь все правильно и работает как нужно! 


Примечание. При чтении данных мы не производим проверку 
их корректности. Если пользователь введет строку вместо чис- 
ла, то выполнение программы будет установлено, а на консоли 
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будет изображено сообщение об ошибке. Для обработки таких 
ситуаций используются блоки {гу..ехсер*, которые мы пока рас- 
сматривать не будем. 


ГЛАВА 6. 


СТРОКИ И СТРОКОВЫЕ 
ФУНКЦИИ 
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6.1. Что такое строка? Выбор кавычек 


Строка — это упорядоченная последовательность символов. Можно даже 
сказать, что строка - это массив символов, поскольку массив - это и есть 
упорядоченная последовательность. 


Строки поддерживают обращение по индексу, конкатенацию (+), повторе- 
ние (*), проверку на вхождение (11). 


В Ру оп строковые значения принято заключать в кавычки — двойные или 
одинарные. Компьютеру все равно, главное, чтобы использовался ОДИН И 
тот же тип открывающейся И закрывающейся кавычки, например: 


рг1пе ("Привет") 
рг1пЕ ('Привет') 


Эти операторы выведут одну и ту же строку. При желании можно, чтобы 
строка содержала кавычки обоих типов: 


рг1пе ("Привет, ‘'мир'!") 


Глава 6. Строки и строковые функции 


Здесь внешние кавычки (двойные) используются для ограничения строко- 
вого значения, а внутренние выводятся как обычные символы. Внутри этой 
строки вы можете использовать сколько угодно одинарных кавычек. 


Можно поступить и наоборот - для ограничения использовать одинарные 
кавычки, тогда внутри можно будет использовать сколько угодно двойных 
кавычек: 


рг1п* ('Привет, "мир"!') 
льзовав кавычки одного ти В ли ограничител й, ВЫ не см Е 
Использовав ка ОДНОГО па О огра. елеи же не сможе 


те пользоваться ими внутри строки. Это целесообразно, ведь второе по по- 
рядку вхождение открывающей кавычки компьютер считает концом стро- 
КИ. 


Функции рг!п() можно передать несколько значений, разделив их запяты- 
ми: 


рг1п* ("Привет", 
"мир ! " ) 


Иногда такой прием используют, чтобы сделать код более читабельным. 


Если вы внимательно читали предыдущие главы, то знаете, что строки яв- 
ляются неизменяемыми типами данных. Именнопоэтому почти все строко- 
вые методы в качестве значения возвращают новую строку, а не изменяют 
существующую. С одной стороны, это хорошо - вам не нужно беспокоить- 
ся, что что-то пойдет не так. С другой, при работе с большими объемами 
данных можно столкнуться с нехваткой памяти. 


Помните, что вы можете получить символ строки по индексу, но изменить 
строку, то есть изменить этот символ, как можно было в других языках 
программирования, нельзя: 


>>> зЕг = "Не11о" 
>>> зЕг[1] 

'е' 

>>> ЗЕЕ =: а" 


ТгасерасК (позе гесепЕ са11] 1а$%): 
Е11е "<рузре11#4>", 11пе 1, 1п <поао1е> 
ес Е Сы 
ТуреЕггог: '56г' ор)есЕе аоез поЕ зиаррог® 1%ем азз19пмепЕ 
>>> 


РУНоп. Полное руководсто О #2. ру+поп 


Руоп поддерживает следующие строковые типы: $%г, Бубез и Бубеагг. Пер- 
вый тип — это обычная Огусоде-строка. Символы хранятся в некоторой 
абстрактной кодировке, а при выводе вы можете указать нужную вам коди- 
ровку с помощью метода епсо4е(): 


>>> а = “Нривет“" 

>>> 5.епсоае (епсоа1па="иЕ-8") 

Ь' \ хаб \х9Е\ха1 \х80\ ха0 \х68\ха0\хЬ2 \ ха0\хЬ5\ха1 \х82' 
>>> 5.епсоае (епсоа1па="ср1251") 

Ь' \ хсЕ\хЕО\ хе8 \хе2\хеб\хЕЗ' 


Тип Буе$ — это неизменяемая последовательность байтов. Каждый элемент 
такой последовательности может хранить целое число от 0 до 255, обозна- 
чающее код символа. Этот тип поддерживает большинство строковых мето- 
дов, однако при доступе по индексу возвращается целое число, а не символ: 


>>> 5 = ру(ев ("Бе11о", "аЕЕ-8") 
О В, [1 

(104; 201,208) 

>22>5 

Ь'ре]11]о' 


Некоторые строковые функции некорректно работают с типом Бувез. На- 


пример, функция [еп() возвращает количество байтов, которые занимает 
строка в памяти, а не количество символов: 


>>> 1еп ("ре1]1о") 

5 

>>> 1еп(Бутез ("Привет", "иЕЕ-8") ) 
12 


В кодировке ОТЕ-8 для кодирования одного символа используется два бай- 


та, поэтому результат — 12, ане 6. 


Тип Бубеаггау — это изменяемая последовательность байтов. Данный тип 
аналогичен типу Бубе$, но вы можете изменять элементы такой строки по 
индексу. Также этот тип содержит дополнительные методы, которые позво- 
ляют добавлять и удалять элементы: 


>>> 5 = БуЕеагкау ("Ве11о0", "аЕЕ-8") 
>>> $[0] = 50; 5 
Бусеаггау (р'2е11]о') 
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6.2. Создание строки 


Создать строку можно, указав ее между апострофами или двойными кавыч- 
ками, как уже было показано выше: 


3>> а = "нео" а 
'Бе11о' 

>>>. В: = "ИЕ 
И 


Данные строки ничем не отличаются, и вы можете использовать любой 
способ, какой вам больше нравится. В РНР есть разница между строками, 
заключенными в кавычки и в апострофы. В Руоп разницы никакой нет. 
Мой совет следующий: если строка содержит апострофы, заключайте ее в 
кавычки, если же строка содержит кавычки, то заключайте ее в апострофы. 
Все специальные символы в этих строках (что в кавычках, что в апостро- 
фах) интерпретируются, например, \& — это символ табуляции, \п -— символ 
новой строки и т.д. Если нужно вывести символ \ как есть, его нужно экра- 
нировать: 


>>> з = "Не11о\\пмог1А"; 3 
'Не11о\ \пмог1а' 


При использовании кавычек и апострофов вы не можете разместить объект 
на нескольких строках. Если нужно присвоить переменной многострочный 
текст, используйте тройные апострофы: 

Бо" 5: = "" "НЕТ О, 

хххх 


ЕЛЕа!: ЖА р" 
Также создать строку можно с помощью функции 57(): 
зЕг (<строка>, <кодировка>, «обработка ошибок>) 


Преимущество этой функции - вы сразу можете указать кодировку, в кото- 
рой находится текст: 


>>> з = эк (Ь'! \ха0\х9Е\ха1 \х80\ха0\хЬ8 \ха0\хЬ2 \ха0\хЬ5\ха1 \ 
х82.", ЧаЕЕ=8*“.): 5 
'Привет' 
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Обратите внимание: ранее мы использовали пример, в котором мы пере- 


менной $4 присваивали значение. Этим мы переопределили идентифика- 
тор $ и при вызове функции $&г вы можете получить сообттение: 


ТгасераскК (мозЕ гесепЕ са]11 1аз®): 
Е11]е "<рузре11#4>", 11пте 1, 1п <моаи1е> 
$ = зЕг (Б' \ха0\х9Е\ха1 \х80\ха0\хЬ8 \ха0\хЬ2\ха0\хЬ5 \ха1 \ 
82" ПЕ) 
ТуреЕггог: 'з6хк' оБ]есе 15$ поЕ са11аЪ1е 


По привычке многие из нас используют идентификатор $ для хранения 
какой-то промежуточной строки. В отличие от РНР где можно использо- 
вать переменную $$ и функцию 5$ (), в Руоп этого лучше не делать, ина- 
че вы не сможете использовать функцию 570). Да, РНР более гибкий язык 
и внем вы легко можете использовать следующий код: 


<?рЬр 
ЕилсТой се (56) 4 
есро $5%г; 
} 
$5Ех = "Не11о'"; 
ЕВЕ); 
2 


Одни сплошные идентификаторы $%г, но в Руфоп так делать нельзя. Зато 
в Руфоп есть строки документирования, которые сохраняются в атрибуте 
__ 90с__. Пример: 


>>> аеЕ Еипс1 (): 
""" Краткое описание """ 
ра$5 


>>> рглпё (РапстР. аос_) 
Тгасераск (поз гесепЕ са11 1а5$®): 

Е11е "<рузпе11#9>", 11пе 1, 1п <моаи1е> 

рге1 п (Еипс1. аос_) 

АБЕЕТБИЕеЕктох: 'Еипсетог" обдесЕ ваз по аеёхтариее " аое" 
>>> рг1п& (Еипс1. _@аос_) 

Краткое описание 
>>> 
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Обратите внимание, что имя атрибута содержит четыре знака подчеркива- 


ния - два до дос и два после, иначе вы получите ошибку. 


Перед некоторыми строками необходимо разместить модификатор г. Спе- 
циальные символы внутри строки будут выводиться как есть, например, \Ё 
не будет преобразован в символ табуляции. Такой модификатор будет поле- 
зен, если вы работаете с регулярными выражениями, а также при указании 
пути к файлу и каталогу: 


>>> рг1пЕ (г"с:\ЕезЕ\фезе.ру") 
с: \сезЕ\+$езе.ру 


Если модификатор не указать, то слеши нужно экранировать: 


>>> рклпЕ("с:\\фезЕ\\+езе.ру") 
с: \СезЕ\фезе.ру 


6.3. Тройные кавычки 


Иногда есть большой фрагмент текста, который нужно вставить в програм- 
му как есть, и вывести в неизменном виде. Конечно, для этого лучше ис- 
пользовать файлы - записать текст в файл, потом в программе прочитать 
текст из файла и вывести его. Но не все программисты хотят усложнять 
программу - и если программа несложная, то можно весь код хранить в од- 
ном файле, чтобы ничего не потерялось. 


Для вывода текста как есть используются тройные кавычки. В листинге 6.1 
мы рассмотрим небольшую программу, выводящую инструкцию по исполь- 
зовании абстрактной программы. Когда мы будем изучать функции, дан- 
ный вывод можно будет оформить в отдельную функцию, а пока разберем- 
ся, как работают тройные кавычки. 


Листинг 6.1. Вывод многострочного текста прямо из 
программы 


ре1пЕ {“* ии 
Использование: ргодгам -1Ё <1прае Н1е> [-оЕ <опЕриаё Н1е>] 


—-1Е: входной файл 
-оЕ: результирующий файл. Если не указан, будет использован 
стандартный вывода 


РУпоп. Полное руководство Ма #2. руепоп 


ин ") 


# Ждем, пока пользователь нажмет Епеег 
1прие ("\Нажмите ЕпЕегк для выхода\п") # Это тоже комментарий 


Текст, заключенный между парой тройных кавычек (""" текст """) выводит- 
ся, как есть — сохраняется форматирование, переносы строк и т.д. Тройные 


кавычки существенно облегчают вывод многострочного текста. 


6.4. Специальные символы 


Внутри строк в Руфоп можно использовать специальные символы, то есть 
комбинации символов, которые обозначают служебные или непечатаемые 
символы, которые нельзя вставить обычным способом. Наверняка, вам зна- 
комы эти символы по другим языкам программирования (см. табл. 6.1). 


Таблица 6.1. Специальные символы 


5 п — восьмеричное значение (код символа), 
например, \50 (символ 2) 
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п — Бех-значение символа (код символа), на- 
пример, \х5Ъ соответствует символу [ 


Обратный слеш 


\ихххх 16-битный символ Ошсоде 
\Охххххххх 32-битный символ Отсоде 


6.5. Действия над строками 


Строки поддерживают следующие операции: 


» Обращение к элементу по индексу; 
е Срез; 

® Конкатенация; 

» Проверку на вхождение; 


® Повтор. 
6.5.1. ОБРАЩЕНИЕ К ЭЛЕМЕНТУ ПО ИНДЕКСУ 


Ранее было показано, как обратиться к отдельному символу строки. Нуме- 
рация символов начинается с 0: 


>>> 8 = "123" 
>>> 3[0], $[1], $3[2] 
". РЕ #3) 


Если обратиться к несуществующему символу строки, получите следую- 
щую ошибку: 


>>> $[3] 
Тгасерасхк (моз® гесепЕ са11 1а5%): 
Е11е "<рузре11#17>", 11пе 1, 1п <моаа1е> 
3[3] 
ТпраехЕггог;: $6г1па 1паех ойЕ оЁ гапае 


Рупоп. Полное руководство | 


Вы можете указать отрицательное значение индекса. В этом случае отсчет 
будет с конца строки: 


>>> $[-1], $5[-2], $[-3] 
('3', т7и., т) 


6.5.2. СРЕЗ СТРОКИ 


Очень интересной является операция среза строки. Ее формат следующий: 
[<5$ах®>: <епа> : <з6ер>] 


Интересна она хотя бы даже тем, что все три параметра являются необяза- 
тельными. Например, если не указан параметр <5аг(>, то по умолчанию 
будет использовано значение 0. Если не указан параметр <еп4>, то будет 
возвращен фрагмент до конца строки. И, если не указан <$ер>, будет ис- 
пользоваться шаг 1. В качестве всех трех параметров можно указать отри- 
цательные значения. 


>>> в = "Не11о" 

>>> 3[:] # Фрагмент от позиции 0 до конца строки 
'Не11о' 
>81] # Отрезаем последний символ строки 
"неш' 
>>>. 5 [182] # Начиная с позиции 1 до конца строки, шаг 2 
Е 
>> 61:1] $ Отрезаем первый символ 
"210" 


Поэкспериментируйте с операцией среза - я уверен, что вам она понра- 
вится. 


6.5.3. КОНКАТЕНАЦИЯ СТРОК 


Конкатенация строк бывает явной и неявной. Явная — это использование 
оператора +, а неявная - это указание двух или более строк рядом - через 
пробел: 


5 ВЕТЫЕ ("Тв "2 
12 

>>> рглпе("1" "2") 
12 
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Преобразовать несколько строк в кортеж можно с помощью запятой, на- 
пример: 

>> 8 = и н2н 

>>> Еуре (3) 


<с1азз '6ир1е'> 


Как видите, мы получили тип фир[е - кортеж, а не строку. Вот только пом- 
ните, что вы не можете выполнить неявную конкатенацию строки и пере- 
менной, например: 


>>> рг1пЕ("З" 3) 
ЗупЕахЕггог: 1пуа11А зупфах 


6.5.4. ПРОВЕРКА НА ВХОЖДЕНИЕ 


Проверить, входит ли подстрока в строку, можно с помощью оператора шт: 
>>> "ре11" 1п "Не11о" 

Ра1зе 

>>> "ре" фл "Не1то" 

Тгое 


Оператор 11, как вы уже успели заметить, чувствителен к регистру симво- 


лов. 


6.5.5. ПОВТОР 


Оператор * позволяет повторить строку определенное число раз, например: 


>>> ргапе("*" * 20) 
ххжххххкххжкхкжккккккккхк 


6.5.6. ФУНКЦИЯ ТЕМ() 


Функция [еп() возвращает количество символов в строке. Напомню, что с 
байтовыми строками эта функция работает некорректно и возвращает ко- 
личество байтов, которые занимает строка: 


Рушоп. Полное руководство О е: ру{Воп 


>>> 1еп ("123456") 
6 
Функцию [еп () можно использовать для перебора всех символов строки: 


>>> в = "123456" 
>>> Еог 1 1п гапае (1еп($)): рг1п®($[1], епа=" ") 


2 3.4.5.6 


Помните, что в случае с Отсоде-строками количество байтов, необходи- 
мых для хранения символов строки, превышает само число символа, и вы 
можете получить ошибку выхода за пределы диапазона. 


6.6. Форматирование строки и метод 
Тогтац) 


6.6.1. ОПЕРАТОР ФОРМАТИРОВАНИЯ % 


Программистам, знающим язык С, знакомая функция р"пё/(), выводящая 
строку в определенном формате. Язык Руоп также поддерживает форма- 
тирование строки. На данный момент в Руфоп поддерживается два способа 
форматирования текста: 


» Оператор % 
» Метод Югтаё 


В следующей версии Руоп оператор % могут удалить, поэтому настоя- 


тельно рекомендуется использовать метод /оттаг. Но не рассмотреть, хотя 
бы вкратце, оператор % мы не можем, поскольку все еще есть множество 
кода, написанного с использованием этого оператора. Формат оператора % 
следующий: 


<Формат> % <Значения> 
Синтаксис описания формата такой: 


$[(<Ключ>) ] [<Флаг>] [<Ширина>] [.<Точность>] <Преобразование> 


Пример использования оператора форматирования: 
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>>> "%5/%5/%5" % (30, 10, 2020) 
'30/10/2020' 


Рассмотрим параметры формата. Первый параметр — <Ключ>. Он задает 
ключ словаря, если он задан, то в параметре <Значения> нужно указать 
словарь, а не кортеж. Вот пример: 


>>> "% (саг) з - %(уеаг)з" % {"саг" : "п1$5ап", "уеах" : 2021} 
'п15зап - 2021' 


Параметр <Флаг> - это флаг преобразования, который может содержать 


следующие значения: 


® #& — ДЛЯ восьмеричных значений добавляет в начало символы Оо, ДЛЯ 
шестнадцатеричных — Ох, для вещественных чисел — будет ВЫВОДИТЬСЯ 
точка, Даже если дробная часть равна 0 


® 0 если указан, будут выводиться ведущие нули для числового запол- 
нения 


® - — задает выравнивание по левой границе области 


® пробел — добавляет пробел перед положительным числом, перед отри- 
цательным будет ВЫВОДИТЬСЯ - 


® + — обязательный вывод знака, как для отрицательных, так и для поло- 
жительных чисел 


Примеры: 


>>> "ъзёх %#х" % (ОхНЕ, 100) 
'ОхНЕ 0х64' 

>>> "®+а %+а" % (-3, 3) 

'-3 +3' 


Параметр <Ширина> определяет минимальную ширину поля, но если 
строка не помещается в указанную ширину, то значение будет проигнори- 


ровано и строка будет выведена полностью. Пример: 


>>> "!510а'! - '%-10а'" % (5, 5) 
иг 5: ие #5 тн 
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Параметр <Точность> задает количество знаков после точки для веще- 


ственных чисел: 


>>> Егом шаей 1троге * 
>>> "%5 %Е %.2Е" % (е, е, е) 
'2.718281828459045 2.718282 2.72' 


Последний параметр <Преобразование> является обязательным и может 
содержать следующие значения: 


» а пытается преобразовать любой объект в строку, используя функцию 
а$с1(); 

® с выводит одиночный символ или преобразует число в символ; 

» (1) — возвращает целую часть числа; 

» е_ вещественное число в экспоненциальной форме (буква "е" в нижнем 
регистре); 


» Е— вещественное число в экспоненциальной форме (буква "е" в верхнем 
регистре); 


е ЕГ(Е) — используется для вывода вещественного числа; 
® 5 то же самое, что или Е (используется более короткая запись числа); 


е С тоже самое, что Е или Е (используется более короткая запись чис- 
ла); 


® $ пытается преобразовать любой объект в строку (с помощью функции 
$7()); 


® Г ТО же, что и $, но для преобразования в строку вместо функции $г() 
будет использоваться функция герг(); 


® © — выводит восьмеричное значение; 
® Хх — Шестнадцатеричное значение в нижнем регистре; 


е Хх шестнадцатеричное значение в верхнем регистре. 


Ранее было продемонстрировано использование модификаторов 4, &, $, х. 
Остальные модификаторы используются аналогично. Вместо множества 
примеров, которые вы и сами можете провести, я подскажу, как правильно 
нужно использовать модификаторы формата и оператор %. 
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Представим, что у нас есть НТМТ--шаблон, который нужно заполнить дан- 
ными. В этом случае идеально подходит оператор % (лист. 6.2). 


Листинг 6.2. Правильное использование оператора % 


фептр1афе = """<[п1> 
<Веаа> 
<Е1+1е>% (+1Е1е) з</+1+1е> 
</неаа> 
<Боау> 
$ (Еехе) $ 
</Боау> 
</вЕт1>" ин 


Чака = { "+11е": "Мой сайт", 
"Бехе": "Контент" } 


рг1пё (Еетр1афе % Чака) 


Переменная фетр/аёе содержит код шаблона, а переменная 4аёа — данные 
шаблона. Затем последним оператором мы заполняем наш шаблон данны- 
ми. Результат изображен на рис. 6.1. 


А. ТОЕЕ 5пе! 392 


Ее Еди $пе! Беьид Орнойб _ Уйпвом Нер 
Русвоп 3.9.2 (+а9з/у3.9.2:1а?9785, Ееь 19 2021, 13:44:55) [М$С %.1928 64 БЬ1е (АМ ^ 
064)] оп м1п32 
Туре "ве1р", “соруг19Ве”, "сге41Ез" ог “11сепзе()" Еог тоге 1пЕогтаЕ1оп. 
>>> 
=-- ——— и еиии АЕОТАКТ: С: \епр\ру\6-2.ру 
<Вст1> 
<пеаа> 
<{1{1е>Мой сайт</+111е> 
</пеад> 
<Боду> 
Контент 


</Ъоду> 
</вЕт1> 
>>> | 
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6.6.2. МЕТОДЫ ВЫРАВНИВАНИЯ СТРОКИ 


Прежде, чем перейти к рассмотрению метода /ютта((), нужно рассмотреть 
дополнительные методы, которые вы можете использовать для выравнива- 
ния строки: 


э сеше’(<Ширина>[, <Символ>]) — выравнивание строки по центру поля 
указанной ширины. Второй параметр задает символ, который будет до- 
бавлен слева и справа от указанной строки. По умолчанию второй пара- 
метр равен пробелу. 


» [7145(<Ширина>[, <Символ>]) — выравнивание по левому краю. 


® 7и5(<Ширина>[, <Символ>]) — по правому краю. 


Примеры: 


зах "НЫ" 
>>> 5.сепфек (20) 
ы Не11о у 


>>> з.сепеек (20, !*') 
тххххххх Не] | ох**ххххх! 


>>> 5.1056 (20) 
'Не11о ' 
У ЕЕ 20) 
} Не11о' 


6.6.3. МЕТОД ЕОВМАТ() 


Метод /ютта) используется для выравнивания строк, начиная с версии 
Ру\Фоп 2.6. Пока еще оператор % оставлен из соображения обратной совме- 
стимости с тоннами уже написанного кода, но в скором времени останется 
лишь метод югта%(). 


Использовать этот метод нужно так: 

<Строка> = <Формат>.ЁЕогма® (*агд5, **Кмага5) 
Синтаксис строки формат следующий: 

{ [<Поле>] [!<Функция>] [:<Формат>] } 


Начнем с параметра <Поле>. В нем можно указать индекс позиции или 
ключ. Помните, что нумерация начинается с 0. Также можно комбинировать 
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именованные и позицифнные параметры. В этом случае в методе юогтаЕ() 
именованные параметры используются в конце: 


>>> "{0}/{1}/{2}".Еогщаф (30, 10, 2020) 

'30/10/2020' 

>>> "{0}/{1}/{2}".Еокмща* (*агг) 

'30/10/2020' 

>>> "{НгзЕпаще} {1азепапме}".ЁЕогмта* (Нхгз&папе="Иван", 
1азпаме="Петров") 

'Иван Петров' 

>>> "{]азфпаме}, {0}".Еогма* ("Иван", 1азкпаме="Петров") 
'Петров, Иван’ 


Параметр <Функция> позволяет задать функцию, с помощью которой об- 
рабатываются данные перед их вставкой в строку. Если указано значение 


5", то данные обрабатываются функцией 5#(), если указано значение "г" — 
функцией терт(), если "а", то — а5сй(). По умолчанию используется функция 


$67(). 


В параметре <Формат> указывается значение, имеющее формат: 


[[<Заполнитель>]<Выравнивание>] [<Знак>] [#] [0] [<Ширина>] [, ] 
[.<Точность>] [<Преобразование>] 


По умолчанию выравнивание выполняется по правому краю, но вы можете 
изменить это поведение с помощью параметра <Выравнивание>. Вы може- 
те указать следующие значения: 

® < — по левому краю; 

® > — по правому краю; 


® ^ — по центру; 


® = — знак числа выравнивается по левому краю, а само число — по правому. 
Пример: 

>>> *'[0:<15}' '{1:>315}'".вотмае("НейТо", "Не]1о") 

"'Не1]1о С Не11о'" 


По умолчанию <Заполнитель> равен пробелу, но вы можете указать любой 
фу" символ, например: 
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>> (0: <15}' 15] ""офогиаЕ Не", ‘Нет 
"'Не1]1о***жжххххх! "Ес Не11о"" 
Параметр <Знак> управляет отображением знака числа: 


® + — знак будет отображаться, как для положительных, так и для отрица- 
тельных чисел; 


®» - — знак будет выводиться только для отрицательных чисел (по умолча- 
нию); 


» пробел — вместо + для положительных чисел будет выводиться пробел, 
для отрицательных - минус. 


Как и в случае с оператором %, параметр <Ширина> задает минимальную 
ширину поля. Если строка не помещается в указанную ширину, то значение 
будет проигнорирована и строка будет выведена полностью. 


Переходим к самому важному параметру -— <Преобразование>. Для целых 
чисел можно использовать следующие модификаторы формата: 


® Б— двоичное значение; 

® с преобразует целое число в соответствующий ему символ; 
® 4— десятичное значение; 

® п_— выводит десятичное значение с учетом настроек локали; 
® о восьмеричное значение; 

» х— шестнадцатеричное значение в нижнем регистре; 


® Х — шестнадцатеричное значение в верхнем регистре. 


Для вещественных чисел можно использовать эти модификаторы: 


® ГиЕ— вещественное число; 


» е_ вещественное число в экспоненциальной форме (буква "е" в нижнем 
регистре); 


» Е_ вещественное число в экспоненциальной форме (буква "е" в верхнем 
регистре); 


® в то же самое, что Фили Е (используется более короткая запись числа); 


® С то жесамое, что Е или Е (используется более короткая запись чис- 
ла); 
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® п— аналогично в, но с учетом настройки локали; 
® % — умножает число на 100 и добавляет символ процента в конце. 


Пример: 


>>> "'{0:6}' '{1:е}'".Еогмае (рф, р1) 
"'3.14159' '3.141593е+00'" 


6.7. Функции и методы для работы со 
строками 


В РуФоп очень много функций и методов для работы со строками. Данная 
книга не является справочным руководством по Руоп (хорошо, что такое 
руководство легко найти в Интернете), поэтому мы рассмотрим только ос- 
новные функции и методы (табл. 6.1 и табл. 6.2). Некоторые из этих мето- 
дов мы рассмотрим в этом разделе, некоторые - далее в этой главе. 


Таблица 6.1. Функции для работы со строками 


Синтаксис 


Преобразует любой объект в строку. Если параметр не 
указан, то возвращается пустая строка. Данная функция 
используется функцией рип) и некоторыми другими 
функциями для вывода объектов 


5" ([<объект>]) 


Возвращает строковое представление объекта. Исполь- 


герг(<объект> 
рг( ) зуется в ШГЕ для вывода объектов 


Возвращает строковое представление объекта, при вы- 
воде объекта используются только АЗСИ-символы 


1еп(<Строка>) Возвращает количество символов в строке 


Примеры: 


азсН!(<объект>) 


>>> зЕг("Не1]о") 
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'Не11о' 

>>> герг ("Не11о") 

и" "Нес" 

>>> азст1 ("Не11о") 

"Нели 

>>> азс11 ("Привет") 

"'\\0041Е\ \00440\ \п0438\ \10432\\00435\ \10442'" 
>>> 1еп ("Привет") 
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Таблица 6.2. Строковые методы (основные) 


Синтаксис Описание 


сар{аЙ2е() Делает прописной первую букву строки 


Возвращает отцентрованную строку, по 
сещег(у и, [9]) краям которой стоит символ ВП (пробел по 
умолчанию) 


Возвращает количество непересекающихся 
соипЕ(з,, [$аг{], [еп4]) вхождений подстроки в диапазоне [начало, 
конец] (0 и длина строки по умолчанию) 


епаз\ В ($) Заканчивается ли строка $ шаблоном г 


Возвращает копию строки, в которой все 


символы табуляции заменяются одним или 
несколькими пробелами, в зависимости от 
текущего столбца. Если ТабЗ!те не указан, 
размер табуляции полагается равным 8 про- 
белам 


ехрап4ваБ$ ( [а Б$12е]) 


Поиск подстроки в строке. Возвращает но- 


вос, [6аге] [еп]) мер первого вхождения или -1 


фогта((*агр$, **Кууаге$) Форматирование строки 
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Поиск подстроки в строке. Возвращает номер 


шдех(з,, [51аг( [еп 
(зв, [ ][еп4] ) первого вхождения или вызывает УааеЕггог 


Состоит ли строка из цифр или букв. Возвра- 


1запит 
О щает тие, если это так 


1за!рВа() Состоит ли строка из букв 


1$ 410) Состоит ли строка из цифр 


Состоит ли строка из символов в нижнем ре- 


1$1о\ег() а 


Состоит ли строка из неотображаемых сим- 
волов (пробел, символ перевода страницы 

155расе() (\Ё), "новая строка" (\п’), "перевод карет- 
ки" (“\г’), "горизонтальная табуляция" (\() 
и "вертикальная табуляция" ('\У')) 


Начинаются ли слова в строке с заглавной 


15НИе() вы 


Состоит ли строка из символов в верхнем ре- 


1зиррег() то 


Преобразует последовательность в строку. 
Элементы разделяются через указанный раз- 


лот(<Последовательность>) делитель. Метод используется так: 


<Строка> = <Разделитель>. 
о1п (<Послед-ть>) 


Делает длину строки не меньшей м4, по 
Пу Су, ЯИсваг=" ") необходимости заполняя последние симво- 
лы символом ЛЙсваг 


Переводит все символы строки в нижний ре- 


1ю\ег() де 
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1567р([<Символы>]) 


рагаНоп(<Разделитель>) 


гер!асе(о14, пем [тах]) 


тбоа($%,, [56аг{], [еп] ) 


го4ех(54г, [56аг{], [еп4]) 


гуи$есмЧ, ЯПеваг=" ") 


грагийоп(<Разделитель>) 


тзрИ( [<Разделитель>[, 
<Лимит>]]) 


г5и1р([<Символы>?]) 


Удаляет указанные или пробельные СИМВО- 
лы в начале строки 


Находит первое вхождение разделителя в 
строку и возвращает кортеж из трех элемен- 
тов: 


Фрагмент до разделителя 
Символ-разделитель 
Фрагмент после разделителя 


Возвращает строку, в которой вхождения 
строки о заменены строкой пеш. Необяза- 
тельный параметр тах устанавливает наибо- 
лее возможное количество замен 


Поиск подстроки в строке. Возвращает но- 
мер последнего вхождения или -1 


Поиск подстроки в строке. Возвращает но- 
мер последнего вхождения или вызывает 
ИциеЕтог 


Делает длину строки не меньшей лай, по 
необходимости заполняя первые символы 
символом АИсваг 


То же, что и рагИйоп, но поиск разделителя 
осуществляется справа налево 


То же, что и 5рй, но поиск разделителя осу- 
ществляется справа налево 


Удаляет указанные или пробельные СИМВО- 
лы в конце строки 
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Разделяет строку на подстроки по указан- 
ному разделителю. Если не указан первый 
ри ([<Разделитель>[, параметр (или передано значение №пте), то 

<Лимит>]]) вместо разделителя используется пробел. 
Второй параметр <Лимит> ограничивает 
количество подстрок 


звагё$ми В ($6) Начинается ли строка 3 с шаблона г 


Удаляет указанные символы в начале и конце 
строки. Если символы не указаны, удаляют- 
$1р([<Символы>]) ся пробельные символы: пробел, табуляция 
(\6 \У), возврат каретки (\г), перенос строки 


(\п) 


Своп-регистра: верхний регистр заменяется 


$\арсазе() а 
на нижний и наоборот 


Делает прописной первую букву каждого 
слова 


иЦе() 


пррег() Переводит все символы в верхний регистр 


Делает длину строки не меньшей \14, по 


Я) необходимости заполняя первые символы 
нулями 
Примеры: 
# Обрезаем пробельные символы 
>>> з = " НефТо \п“ 
>>> з.зЕк1р () 
'Не11о' 


# Методы работают с копией строки, поэтому исходная строка 
# не изменяется 

>>> 5 

' Не1]о \п' 

>>> 5.156 г1р () 

'Не11о \п' 

>>> з.гзбк1р () 

' ето“ 
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# Метод $зр11%() без параметров 
>>> з = "поле1 поле? полеЗ3" 
>>> з.зратЕ() 

['поле1', 'поле2', 'поле3з'] 

# Параметры Мопе, 1 

>>> зезрыи (Моце, 1) 

['поле1', 'поле2 поле3'] 


# Метод рагЕ1е1оп() 
>>> з.раретешон(“” =) 


("толе 1", * Та Тмоле2 полез”) 
>>> 5.грагЕ1Е1оп(" ") 
(‘поле1 поле?', ' ', "'поле3') 


# Пример использования ]о1п() 
веру 

>>> 51 = зер.]о1т (["поле1", "поле?"]) 
>>> 31 

‘поле]1 поле?' 


# Функции изменения регистра 
>>>. 3 = "Не1То, мог1а“" 
>>> 5з.сар16а112е() 
'Не11о, мог1а' 

>>> 3.Е1Е1е() 

'Не11о, Мог1а' 

>>> э.иррег () 

"НЕГО, МОВЬП!' 

>>> 5.1омег () 

"ве]То„ моста! 

>>> 5.змарсазе () 
'НЕЪЬО, МОВЬО" 


Также вы можете использовать функции сй7() и 074(). Наверняка вы зна- 


комы с ними, если знаете другие языки программирования. Первая возвра- 
щает символ, соответствующий заданному коду, а вторая — возвращает код 
символа: 


>>> (©8155) 


ВА 
>>> юЕа('7") 
55 
>>> ев 5055) 
'5' 
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6.8. Настройка локали 


Локаль — это совокупность локальных настроек системы (формат даты, 
формат времени, кодировка, форматирование денежных единиц и чисел 
и т.д.). Для установки локали используется функция $еНоса[е() из модуля 
1юса[е. 


Синтаксис функции следующий: 
зеЕ1оса1е (<категория>, <локаль>) 


Категория задает категорию настроек, которые будут изменены после вы- 
зова 5еНоса[е(): 


® [С_А[ГТ.с все настройки; 

® ГС МОМЕТАБКУ — для денежных единиц; 

е [С ТМЕ — настройки, влияющие на форматирование даты и времени; 
е [С МОМЕКС — настройки, влияющие на форматирование чисел. 
Пример: 


1прогЕ 1оса1е 
1оса1е .зе 1оса1е (1оса1е.1С_АЦЬ, ('гизз1ап')) 


6.9. Поиск и замена в строке 


Для поиска и замены в строке в РуФоп используется множество методов. 
Начнем с метода диа(), формат которого выглядит так: 


<строка>.Нпа (<подстрока>[, <начало>[, <конец>]]) 


Метод осуществляет поиск подстроки в строке. Последние два параметры 
необязательны. Если они указаны, то производится операция среза строки: 
<Строка> [<Начало> :<Конец>] 


Метод возвращает номер позиции, с которой начинается вхождение под- 
строки в строку: 


>>> з = "ре11о, мог1а" 
>>> пам = з.Нпа ("мог1а") 
>>> пам 

7 


Рупоп. Полное руководство ‚`В [ руфпоп 


Если подстрока не входит в строку, возвращает -1. 


Метод таех() похож на метод Лпа(), но возвращает исключение У/иеЕтот, 
если подстрока в строку не входит. 


Следующий метод -— 7#пта(): 
<строка>.гНпа (<подстрока>[, <начало>[, <конец>]]) 


Похож на метод Лпа(), но возвращает позицию последнего вхождения под- 
строки в строку или -1, если подстрока не входит в строку. 


Метод соип{() возвращает число вхождения подстроки в строку. Если под- 
строки нет в строке, метод возвращает 0. Метод зависит от регистра сим- 
волов. Синтаксис метода такой: 


<строка> .соип (<подстрока>[, <начало>[, <конец>]]) 


Метод %айзший() возвращает Пие, если подстрока есть в строке, или же 
Еабе, если подстрока не входит в строку. Синтаксис: 


<строка>.зЕаг®$м1ЕВ (<подстрока>[, <начало>[, <конец>]]) 


Метод еп@5ший() возвращает Г’ие, если строка заканчивается указанной 
подстрокой. Если подстроки нет в строке, возвращается Рабе: 


>>> 5. 5багезм1 ЕН ('мог1а') 

Еа1зъе 

>>> 5.епази1 РН ('мог1а') 

Тгае 

Метод терасе() реализует замену всех вхождений подстроки в строку на 
другую подстроку. Замена: 

<Строка> .гер1асе (<Заменяемая подстрока>, <Новая подстрока>[, 
<Лимит>]) 

Параметр <Лимит> необязательный и ограничивает максимальное ко- 


личество замен. 


>>> 5.гер1асе ('мог1А', 'геааег!') 
'ре11о, геааег!' 


руно 
6.10. Что в строке? 


В Руоп есть ряд методов, позволяющих проверить тип содержимого стро- 
ки. Вы можете использовать их для проверки ввода пользователя (табл. 
6.3). Аналогичные методы есть в других языках программирования, напри- 
мер, в РНР 


Таблица 6.3. Методы проверки типа содержимого строки 


Синтаксис Описание 


1312160 Возвращает Гуе, если строка состоит только из цифр 


Возвращает Трие, если строка содержит только десятич- 
ные символы 


Возвращает Тие, если строка содержит только числовые 

Не НО () символы. К числовым символам относятся не только де- 
сятичные цифры, но и дробные числа, римские числа и 
Т.Д. 


1$Чесипа!() 


. Метод возвращает ие, если строка содержит только бук- 
1за!рВа() ча 

155расе() Трие, если строка состоит только из пробельных символов 

ззаниий() Трие, если строка содержит только буквы и/или цифры. В 

противном случае и для пустой строки возвращается Еа|5е 

ыохег() Возвращает Тие, если строка содержит все символы в 
нижнем регистре 

зиррег() Возвращает Ёие, если строка содержит все символы в 
РР верхнем регистре 


Все эти методы возвращают Рае, если строка не прошла соответствующую 
проверку. Например: 


>>> аде = 1прие ('Ваш возраст: ') 

Ваш возраст: 37 

>>> 1Е аде.15а191е() == Тгие: 
РЕЗПЕ ('О0К") 

е15е: 


рг1п ('Ошибка') 


6.11. Шифрование строк 


Модуль БазБ ИНЬ содержит функции, позволяющие зашифровать строки. 


Этот модуль очень и очень полезный. Пароли пользователей принято хра- 
нить в базе данных в зашифрованном виде. Чтобы не изобретать колесо за- 
ново, вы можете использовать модуль Баз ПЪ, содержащий функции п45(), 
зВа1(), зВа256(), зВа384, зВа512(). Названия функций соответствуют алго- 
ритмам шифрования. 


Пример шифрования пароля с использованием алгоритма МО5: 


>>> парогЕ Ва5р11Ь 

>>> Вазр = ВазЬ116.па5 (ъ"зесгеёе") 

>>> Вазр.а1аез* () 
ь'^\хре"\х94\хес\ха0\хе0\хЕО\х8е\хабу\х90\ха2\хаб\хее1' 
>>> ВазВ.реха1аез* () 


'5е5е2294еса0е0Е08еаь769042абееб9' 


В базе данных сохраняется, как правило, значение, возвращаемое методом 


пех@вез((). 


6.12. Переформатирование текста. 
Фиксированное число колонок 


Для переформатирования текста для вывода используется модуль фехё\гар. 
Например, представим, что у нас есть следующие строки: 


5 = " Гогем 1рзим ао1ог $16 аще, сопзесеееаг а@1р1зс1па е11е. 
Оп1запце $516 амеЕ а1ам ай1$ г151$ 1п6егаим $0111с16аа1п. Тп 
уезЕ1и1ит, 115его 1А пах1тиз$ 1]ас1п1а, 1ео пазза ррагеёга п1, 
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У1$Сае розцеге 11рего Яи1 пес 1есеаз. ОЕ ас пипс заа1®61$, 
сопзеацаЕ егоз едеЕ, 919п1п13зз1м ех. У1уащаз ас п1$1 ЁЕе11$. Тп 
ассомзап $г1361аае а11ааее. Могкр1 ей уаг1аз агпа. Богем 1рзим 
Яо1ог 31% амее, сопзесфебаг а@1р1зс1па е11®. Сагаб16аг пес 
игпа $16 амее 11Бего фетрог гНопсиз. №11а Ёх1п911]а егаЕ $1 
атеЕ апдае 1аогееф уо]акрае. Еб1ам а113з шо1езЕ1е г13и$. Могр1 
зар1еп п15$1, зсе1ег1заае зеа Вп1риаз поп, р1асега® зеа е11%. 
Зеа р1асега®е $игр13з ас \уаг1аз &1пс1А0пе. Могр1 Еигр1з мебаз, 
по1езЕ1е ец ега® ец, ц1&г1с1ез $з0111с1аа1п 1огем." 


Далее вы можете использовать модуль фехё\гар для переформатирования 
текста различными способами: 


>>> ипрогЕ фехеигар 
>>> рг1п (фехёигар .ЙЯ11(з, 70)) 

Тогем 1рзам Чо1ог 316 амее, сопзесфееаг аЯ1р1зс1па е11%. 
Оп1запе $1% 
атее Я1ам ач01$ г1зиз 1п6егаим $0111с16аа1п. Тп уезе1ра1ам, 
11Бего 1а 
пах1таз ]ас1п1а, 1ео мазза рвагеега п1, \16ае розиеге 11рего 
Яи1 пес 
1есба$. ЧЕ ас пипс за91661$, сопзеаца® егоз едее, а19п11$51м 
ех. 
\У1уамиз ас п131 ЁЕе113. Ти ассамзап $г13з61а0ое а11ааее. Могр1 ец 
уаг1а$ 
игпа. Гогем 1рзам Чо1ог 31% амее, сопзесеееаг а@1р1зс1па е11%. 
Сигаб16ахг пес игпа 316 амее 11рего фетрог гВопсиз. М№11а 
Ех1п911]а 
егаЕ °з1Е атмеЕ апдиае 1аогееЕ уо]1аЕра®. Е®1ам 4113 по1езЕ1е 
г1305. Могрт 

зар1еп п131, зсе1ег1заае зеа Ёп1риз поп, р1асегаф зеа е11+. 
5еа 
р1асегае Еигр13 ас уаг1аз Е1пс1Аипе. Могр1 6агр1з щебаз, 
по1езЕ1е еп 

егаф ей, 11%г1с1ез $0111с16аа1п ]огем. 
>>> 


>>> рг1п (фехёигар.йЯ11 (3, 40)) 

Тогем 1рзам Яо]ог 316 амеЕ, сопзескевагк 
аЯ1р1зс1па е116. Оп1заие $з1Е амеф а1ам 
911$ г1заз 1псегаим 30111с16аа1п. Тп 
уезЕ1юи1им, 115его 14 пахлтиз 1]аслпта, 
1ео пазза рвагеега м1, \у1ае розиеге 
11рего 911 пес 1есба$. ОЕ ас пипс 
зач1{{1$, сопзеацаЕ егоз едее, 91911$$1тм 
ех. \У1уатиз ас п1$1 ЁЕе11$3. Тп ассотзап 
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фг1зЕ1аце а11апее. МогЬ1 еи уаг1и$ игра. 
Тогем 1рзим 4о1ог $1% амефе, сопзескееиг 
аЧ41р1$с1пд е11е. Сигаб1иг пес игпа $1 
апее 11рего Еетрог гВопсиз. №11а 
Ех1п9111а егае з1& атмеЕ апцаие 1аогее* 
У011%ра*. Е1ам аи1$ по1езЕ1е г151$. 
Могр1 зар1еп п15$1, зсе]1ег1заие зеа 
Нп1Биз поп, р1асегаЕ зе е11+. 5еа 
р1асега® +игр1$ ас \Уаг1из$ 1пс1аппе. 
Могр1 игр15 пее15$, по1ез®1е еи егаё е\ц, 
11611с1е$ $0111с1еи41п 1огем. 


>>> ргапЕ (ехечгар.й11 (3, 40, 1п1%1а1 1п4епе=' ')) 

Тогем 1рзим 401ог $1 аме\, 
сопзессееиг аЧ1р1зс1па е11%е. Оц1зачце 31% 
апее Ч1ам 411$ г1$и$ 1пеегаим 
50111с16141п. Тпл уезЕ1ра]1ит, 11Бего 1а 
пах1миз 1ас1п1а, 1ео мазза рБагефга п1, 
У1$ае розиеге 115его Чи1 пес 1ес®аз. 0% 
ас пипс з$а491*1$, сопзеаиа® егоз$ еде\, 
91911$5$1м ех. \У1уатиз ас п15$1 Ёе11$. Тп 
ассимзап +г13%1аце а11апее. МогЬ1 еп 
Ууаг1и$ игпа. .огем 1рзим 4о1ог 316 амее, 
сопзесфееиг аЯ1р1зс1па е11Ф. Сигаб1ихг 
пес игпа $16 атмеб 11рего Еетрог грВопсиз. 
№11]а Ёг1п911]а ега®е $1 амефе ацаче 
]1аогеее \уо1\1%рае. ЕЕ1ам а11$ мо1езЕ1е 
г15и5. Могр1 зар1еп п15$1, зсе1ег1заце 
зеа Нп1Биз поп, р1асега® зе е11ф. 5еа 
р1асега® игр1$ ас \Уаг1и$ &1пс1аАип®. 
МогЬ1 Еигр1з пебиз, мо1ез1е еп ега® ец, 
11Ег1с1е5$ $0111с1%иА1п 1огеп. 


Модуль фехё\гар — простой способ подготовить текст для вывода, особен- 
но, если вы хотите аккуратно вывести его на терминал. Получить количе- 
ство колонок терминала можно, используя метод 05.5еЁ бетпта[ 512е(). На- 
пример: 


>>> иироге оз 

>>> оз.деЕ_+егт1па]1_312е() .со]мтлз 
80 

>>> 


У метода ЛИО есть несколько дополнительных параметров, управляющих 
табуляцией, окончанием предложений и т.д. 


ГЛАВА 7. 


РЕГУЛЯРНЫЕ 
ВЫРАЖЕНИЯ 
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7.1. Введение в регулярные 
выражения 


В этой книге мы уже рассмотрели функцию поиска подстроки в строке 


— метод дпа(). Реализовать поиск нужной нам строки в файле с помощью 
этой функции не составит проблем. Все, что нам нужно — это прочитать 
файл в одну большую строку (благо, размер строки в Ру\фоп не ограничен, 
в отличие от некоторых других языков программирования, где размер стро- 
ки ограничен 255 символами) и вызвать метод Пи4(), передав ей искомую 
строку. 


Но наша задача существенно усложняется, если мы знаем, только, как долж- 
на выглядеть искомая строка, но мы не знаем точно, какую строку мы ищем. 
Сейчас поясню, что имеется в виду. Представим, что у нас есть текстовый 
файл, в котором нужно найти все адреса е-та!. Мы не знаем, какие именно 
адреса будут в этом файле, поэтому мы не можем указать точную строку 
для ее передачи методу /п4(). Мы только лишь знаем, как будут выглядеть 
искомые строки: строка_без_пробелов®имя_домена1.имя_домена2...имя 
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доменаМ.ТТ.О (ТГО - это Тор Геуе! Роташ - домен верхнего уровня, 
например, .сот, .пеё и т.д.). Представьге, какой нужно написать алгоритм 
поиска всех е-тай, реализованный с использованием метода /п4(). Сначала 
нам нужно найти символ @ - это единственное, что нам известно, этот сим- 
вол будет в любом е-тай. Затем нам нужно найти позиции пробелов до и 
после символа @. Затем нужно выделить строки от первого пробела (кото- 
рый находится перед предполагаемым е-та!) и от символа @ до первого 
пробела, стоящего после него. Затем проанализировать, чем являются эти 
строки. Например, если длина доменного имени слишком короткая или не 
содержит точек, то наша строка явно не является е-та!. Одним словом, ал- 
горитм поиска будет слишком сложным. 


Намного проще использовать регулярные выражения. Регулярное выра- 
жение -— это шаблон искомого текста. Если найденный текст соответствует 
шаблону, говорят, что он соответствует регулярному выражению. При этом 
ваша программа не будет громоздкой - вам нужно лишь вызвать функцию 
поиска по регулярному выражению. 


Поддержка регулярных выражений содержится в модуле ге: 


1троге ге 


Примечание. Ранее модуль, обеспечивающий поддержку регу- 
лярных выражений, назывался гедех, но, начиная с версии 2.5, 
его поддержка была удалена. 


7.2. Функция сотрй!е() и основы 
регулярных выражений 


Функция сотрие() позволяет создать откомпилированный шаблон регу- 


лярного выражения. Вызывать ее нужно так: 


<Шаблон> = ге.сопр11е (<Регулярное выражение>[, <Модификатор>]) 
Параметр модификатор может содержать следующие флаги: 


» Аили АЗСИ — классы \м\, \\/, \Ь, \В, \4, \О, \$ и \$ будут соответство- 


вать обычным символам 
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е Г. или ГОСАТЕ — учитывает настройки текущей локали 
» Гили [СМОКЕСАЗЕ — поиск без учета регистра 


е® М или МУЕТПАМЕ — поиск в строке, которая состоит из нескольких 
подстрок, разделенных символом новой строки ("\п"). Символ ^ соот- 
ветствует привязке к началу каждой подстроки, а символ $ — позиции 
перед символом перевода строки 


» Зили ПОТА. — символ "точка" соответствует любому символу, вклю- 
чая символ перевода строки (\п). По умолчанию "точка" не соответству- 
ет символу перевода строки. Символ ^ будет соответствовать привязке к 
началу строки, а $ — привязке к концу всей строки 


® Хили УЕКВОЗЕ — пробелы и символы перевода строки будут игнори- 
рованы. Внутри регулярного выражения можно использовать коммен- 
тарии 


» Пили ОМ!СОПЕ - классы \м, \\\, \Ь, \В, \а, \О, \5 и \$ будут соответ- 
ствовать Оп1соде-символам. В Руоп 3 флаг установлен по умолчанию 


Рассмотрим несколько примеров: 


>>> пирогкЕ ге 

# Игнорируем регистр 

>>> р = ге.сопр11е (г"^[а-2]+$", ге.Г) 

>>> рг1пЕ ("Найдено" 1ЕЁ р.зеаксВ ("АВС") е1зе "МоЕ Еоипа") 
# Найдено, хотя в строке символы в верхнем регистре, а в 
шаблоне - в нижнем 

Найдено 


# Регистр символов не игнорируется 

>>> р = ге. сотр 1е (г"^ [а-2]+$") 

>>> рге1пЕ("Найдено" 1Е р.зеаксьЬ ("АВС") е1зе "Не найдено") 
# Не найдено 

Не найдено 


>>> р = ге.сотр11е(г"^.5$") 
>>> рг1 п ("Найдено" 1Е р.зеаксВ ("\п") е1зе "Не найдено") 
Не найдено 


Посмотрите на примеры - до строки, содержащей регулярное выражение, 
указывается модификатор г. Мы используем неформатированные строки — 
если модификатор не указывать, то все слэши нужно будет экранировать. 
Например, строку: 
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р = ге.сотр11е (х"^\а+$") 


нужно будет записать так: 


р = ге.сопр11е ("^\\а+$") 


Внутри регулярного выражения символы .., ^, $, *, +, ?, {, [, ), \, 1, (и) имеют 
специальное значение. Если эти символы должны трактоваться как есть, то 
их следует экранировать с помощью слэша. Некоторые специальные сим- 
волы теряют свое особое значение, если их разместить внутри квадратных 
скобок. 


Например, символ "точка" по умолчанию соответствует любому символу, 
кроме символа перевода строки. Если необходимо найти точку, то перед ней 
нужно указать \ или разместить точку внутри скобок - [.]. 


Рассмотрим небольшой пример: 


>>> АЕ =; "01.:01:20241" 

>>> р = ге.сопр11е (г"^ [0-3] [0-9]. [01] [0-9]. [12] [09] [0-9] [0- 
91$") 

>>>» ЛЕ р.зеаксв (а+.) : реф п ("+") 

+ 


В этом примере мы использовали методы ^ и $. Кроме этих символов есть 
метасимволы \А и \2. Назначение этих метасимволов следующее: 


® ^ — привязка к началу строки или подстроки (зависит от флагов М или 
5) 

® $ привязка к концу строки или подстроки (зависит от флагов М или 5) 

® \А привязка к началу строки (без зависимости от модификатора) 


® \7— привязка к концу строки (без зависимости от модификатора) 


Примеры: 


# Точка не соответствует \п 

>>> р = ге.сотр11е (х"^.+$") 

>>> р.Нпаа11 ("з31\п52\пз3") 

[1 

# Точка соответствует \п 

>>> р = ге.сотр11е(х"^.+$", ге.5) 
>>> р.Нпаа11 ("$1 \пз2\п\5$3") 
['31\п52\п\\53'] 


РУоп. Полное руководстто 9 2 ру+поп 


Привязка к началу или концу строки используется, только если строка 


должна полностью соответствовать регулярному выражению. Давайте на- 
пишем программу, которая проверяет, является ли строка числом: 


1трогЕ ге 


р = ге.сошр11е (г"^ [0-9]+$", ге.5) 
пим = "123" 
эпим = "$123" 


1Е р.зеаксВ (пам): 
рге1пе ("Число") 
е15е: 
рее ("Строка") 


1Е р.зеаксВ (пом): 

рг1пЕ ("Число") 
Е1=е: 

рг1п& ("Строка") 
Результат выполнения этого модуля будет следующим: 
Число 
Строка 
Сначала мы передаем строку, которая содержит только число, поэтому бу- 
дет выведено Митфе’. Далее мы передаем строку, которая не полностью со- 
стоит из числа, поэтому будет выведено 5#ир. 
В квадратных скобках указываются символы, которые могут встречаться на 
этом месте в строке. Диапазон символов перечисляется черезтире. Примеры: 
е [13] — соответствует числу 1 или 3 
» [0-9] соответствует числу от 0 до 9 
® [а6с] — соответствует буквам "а", "Б" или "с" 


» [а-7| — соответствует буквам от "а" до "7 


® [а-2А-7]| — соответствует любой букве английского алфавита 


» [0-9а-2А-7] — любая буква или любая цифра 
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С помощью символа ^ можно инвертировать значение, указанное в скобках. 
Вы можете указать символы, которых не должно быть на этом месте в стро- 
ке, например, [^13] - символов 1 и Зне должно быть в строке. 


Если не хочется указывать символы, то можно указать сразу классы симво- 
лов (табл. 7.1). 


Таблица 7.1. Классы символов 


Класс символов Что означает 
Соответствует любой цифре 


Соответствует любой букве, цифре и знаку подчерки- 
вания. Эквивалентно [а-2А-7.0-9_] при указании фла- 
га А 


Любой пробельный символ. При указании флага А 
эквивалентно [\\п\г\ ВУ] 


Не буква, не цифра и не символ подчеркивания. Эк- 
вивалентно [^а-2А-7.0-9 | 


Не пробельный символ, эквивалентно [^\\п\г\В\У| 


Не цифра. При указании флага А эквивалентно [^0-9] 


Количество вхождения символа в строку задается с помощью квантифика- 
торов: 


® {п} — п вхождений символа в строку. Например, г"^[0-9]{3}$" соответ- 
ствует трем вхождениям любой цифры 

» {п,} — минимум п (п или больше) вхождений символа 

® {пт} — отп до м вхождений 

® * — ноль или больше вхождений символа в строку. Эквивалентно {0,} 


® + — одно или больше число вхождений символа в строку. Эквивалентно 
{1,} 

® ?— ни одного или одно вхождение в строку. Эквивалентно комбинации 
{0,1} 


РУпоп. Полное руководство 


Регулярные выражения по умолчанию "жадные". Тоесть ищут самую длин- 
ную последовательность, которая соответствует шаблону, и не учитывают 
более короткие соответствия. Рассмотрим следующий пример: 


>; ру{Поп 


>>> 3 = "<1>0дин</1><1>Два</1><1>Три</1>" 


>>> р те. Сор: 16 (к"ч1.%</1>", те. 9) 
>>> р.Нпаа11 ($) 
['<1>Один</1><1>Два</1><1>Три</1>'] 


Как видите, была найдена вся строка. Это немного не то, что мы хотели. 
Чтобы ограничить "жадность" регулярных выражений, нужно использо- 
вать символ ?: 


>>> р = ге.сотрт1е (г"<1>.*?</1>", ге.5) 

>>> р.Нпаа11 (5$) 

['<1>0дин</1>', '<1>Два</1>', '<1>Три</1>'] 
>>> 


Теперь вместо одного большого соответствия у нас есть три меньших. 


Мы только что рассмотрели основы синтаксиса регулярных выражений 
Рег. Дополнительную информацию вы можете получить по адресу: 


йИр/ Ию. оо5Е.075/4ос/Ь$/1_43_0/ПЬ5/тевех/4ос/итИБоо$Е_тевех/ 
зутах/рей_зутахйнт 


7.3. 


етоды тат<й() и зеагсПп() 


Метод тасй() проверяет соответствие с началом строки. Формат метода 
следующий: 

пафсй (<Строка>[, <Начальная позиция>[, <Конечная позиция>]]) 
Если соответствие найдено, то возвращается объект МабсВ, в противном 
случае — № те. Пример: 

>>> р = ке.сотр11е (' [0-9]+') 


>>> рг1пё ("Найдено" 1Е р.мабсп ("$5123") е]1зе "Не найдено") 
Не найдено 
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>>> рг1пё ("Найдено" 1Е р.табсВ ("1235") е1зе "Не найдено") 
Найдено 
>>> 


Метод 5еатсй() проверяет соответствие с любой частью строки: 


зеагсВ (<Строка>[, <Начальная позиция>[, <Конечная позиция>]]) 


Пример: 


>>> р = ге.сотшр11е (' [0-9] +') 

>>> рг1пё("Найдено" 1Е р.зеагсВ ("$123") е15е "Не найдено") 
Найдено 

>>> рг1пЕ ("Найдено" 1ЕЁ р.зеагсь ("1235") е1зе "Не найдено") 
Найдено 


Объект Май, возвращаемый методами табсЬ() и зеагсВ() имеет следую- 

щие свойства и методы: 

® ге— ссылка на скомпилированный шаблон, указанный в методах таёсЬ() 
и зеагсЬ() Через нее доступны следующие свойства и методы: 

® 2гопрз — количество групп в шаблоне 

® роиршаех - словарь с названиями групп и их номерами 

® 5(гшрё — значение параметра <Строка> 

® роз — значение параметра <Начальная позиция> 

® епароз — значение параметра <Конечная позиция> 

® |а5Ип4ех - номер последней группы или значение №те 


® [а5бегоир — название последней группы 


® заге([<Номер группы или название>]) — индекс начала фрагмента. 
Если параметр не указан, то фрагментом является полное соответствие 
с шаблоном, в противном случае — соответствие с указанной группой. 
Если соответствия нет, то возвращается значение -1 


®е епа([<Номер группы или название>]) — индекса конца фрагмента. Если 
параметр не указан, то фрагментом является полное соответствие с ша- 
блоном, в противном случае - с указанной группой. Если соответствия 
нет, то возвращается -1 


® ехрапа(<Шаблон>) — производит замену в строке согласно указанного 
шаблона 


Рупоп. Полное руководство оо в. руепоп 


В качестве примера работы с регулярными выражениями рассмотрим код, 
проверяющий правильность введенного е-тай (лист. 7.1). 


Листинг 7.1. Код, проверяющий правильность е-тай 


1троге ге 
ета11 = "махк@за1ез.ехатр1е.сом" 


раееегп = к"^ ([а-20-9_.-]+)@ ( ([а-20-9-]+\.)+[а-2] {2,6}) $" 
р = ге.сотр11е (рае егп, ге.Т | ге.5) 


ш = р.зеагср (ета11) 


1Е поЁ м: 

рг1п® ("Не совпадает") 
е15е: 

рг1п® ("Совпадает") 


7.4. Метод Япаа|() 


Метод ДпааЙО ищет все совпадения с шаблоном. Формат метода: 


Нпаа11 (<Строка>[, <Начальная позиция>[, <Конечная позиция>]]) 


Если найдены соответствия, то возвращается список с фрагментами, в про- 
тивном случае возвращается пустой список. Если внутри шаблона есть 
несколько групп, то каждый элемент списка будет кортежем, а не строкой. 
Рассмотрим пример: 


>>> р = ке .сотшр11е (г"[а-2]+") 
>>> р.Нпаа11("арс, Ьса, 123, 43Е") 
в'аве“; ‘Беа“,."а5е"] 


>>> р.Нп4а11 ("1234, 12345, 123456") 
[] 


7.э. Метод $и6() 


Метод 56 () используется для поиска всех совпадений в строке с шаблоном 
и для их замены указанным значением. Если совпадения не найдены, будет 
возвращена исходная строка. Синтаксис метода следующий: 
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55 (<новый фрагмент>, <строка для замены> [, «максимальное 
количество замен>]) 


Внутри нового фрагмента можно использовать обратные ссылки \номер \ 
Номер и \5Название. Обратные ссылки предоставляют удобный способ 
идентификации повторяющегося символа или подстроки в строке. Напри- 
мер, если входная строка содержит несколько экземпляров произвольной 
подстроки, то можно найти первое вхождение с помощью группы записи, а 
затем использовать обратную ссылку для поиска последующих вхождений 
подстроки. Чаще всего используются ссылки типа \номер. Номер - это 
порядковое положение группы записи, определенное в шаблоне регуляр- 
ного выражения. Например, \4 соответствует содержимому четвертой за- 
хватываемой группы. 


В качестве первого параметра можно использовать ссылку на функцию. В 
функцию будет передан объект Ма{Б, соответствующий найденному фраг- 
менту. Результат, возвращаемый этой функцией, служит фрагментом для 
замены. Для примера найдем все числа в строке и умножим их на 2 (лист. 
7.2) 


Листинг 7.2. Использование метода зи 


1трогЕ ге 


аеЁ моа1 (м): 
х = 116 (м.агочр (0)) 
х *=2 
гееигп "{0}".Еогма® (х) 


р = ге.сошр11е (г" [0-9] +") 

# умножаем все числа на 2 

рези (р.з9Ь (ти1%, "2, З, 4, 5, 6, 7")) 

# умножаем первые три числа 

РЕ (роза оаеые, "2 Зы ар я б, 7" 3] 


Результат: 


д, 6; 8, 10; 412, 14 
4, 6, В; 5, 6 Ч 


Обратите внимание, что для вызова функции не нужно указывать фигур- 
ные скобки. 


Далее будут рассмотрены некоторые примеры, демонстрирующие исполь- 
зование регулярных выражений на практике. 


РУПоп. Полное руководство мм = ру Поп 


7.6. Различные практические 
примеры 


7.6.1. РАЗДЕЛЕНИЕ СТРОК С ИСПОЛЬЗОВАНИЕМ 
РАЗДЕЛИТЕЛЕЙ 


Представим, что у нас есть строка и нам ее нужно разделить на поля, ис- 


пользуя разделители, например, пробелы. Чтобы задача была менее триви- 
альной, будем считать, что разделители и пробелы вокруг них противоречи- 
вы по всей строке. 


В самых простых случаях можно использовать метод 5рй{() объекта строки. 
Но он не позволяет использовать несколько разделителей и учитывать воз- 
можное пространство вокруг разделителей. В нашем случае нужна большая 
гибкость, поэтому нам нужен использовать метод 5рй() из модуля ге: 


>>> 11пе = 'азаЕ Е]ак; аЁеа, ЕЗек, азаЕ, Еоо' 
>>> пирокЕ ге 

>>> ге.зр11%(х'[;,\з]\з*', 11пе) 

р'азаЕ", ‘ела’, татеа"„. “Рек. таза“, "200 


Метод те.зрйЁ() полезен, потому что вы можете определить многократ- 
ные образцы для разделителя. например, как показано в решении, разде- 
литель может быть или запятой (,) или точкой с запятой (;) или пробелом, 
сопровождаемым любым количеством дополнительных пробельных симво- 
лов. Каждый раз, когда найден образец, все соответствия ему становятся 
разделителем между любыми полями, лежащими по обе стороны от соот- 
ветствия. Результат — список полей, как и в случае с 5.50. 


При ‘использовании те.зрЁё() нужно быть осторожным, образец регулярно- 
го выражения должен содержать группу захвата, заключенную в круглые 
скобки. Если используются группы захвата, то соответствующий текст так- 
же будет включен в результат. Например: 


>>> Яе14з = ге.зр11е(г'(;|,|\3)\з*', 11пе) 

>>> Ве1Аз 

['азаЕ', ' 1: 'ЕЗак', ро 'аЁе4', р 'Е)ек', в 'азаЕ', 
ей "ЕбО,"] 

>>> 
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Получение символов разделителя может быть полезным в определенных 
контекстах. Например, возможно, вы нуждаетесь в символах разделителя, 
чтобы преобразовать выходную строку: 


>>> уа1щез = ве1аз[::2] 

>>> Чде111{егз = йе1а3[1::2] + [''] 

>>> уа1пез 

заза”, ‘Еуах’, ‘авеа’», "век, "азав”, 3Ео0’] 
>>> ае11п1{4егз 


[[* 1 ..т ' ' ' ' ' ' м 
’ ба 1 г г г ’ ’ ГА 


>>> # Преобразуем строку с использованием тех же разделителей 


>>> ''.3)о1л (у+А Еог у,@ 1п 21р(уа1аез, 4е111%егз)) 
'азаЕ Е)АК;аЕеа, Е)ек, азаЕ, Еоо' 
>>> 


Если вы не хотите получить символы разделителя в результате, но вам все 
еще нужны круглые скобки для группировки частей образца регулярного 
выражения, убедитесь, что вы используете группы не захвата, которая опре- 
деляется как (?...). Например: 


>>> ге.зр11%(к'(?:,|;|\3) \з*', 11пе) 
["азаЕ", “ЕАК”, "“авеа"“, "Бек", "азаЕ", "Роо!’] 
>>> 


7.6.2. ИСПОЛЬЗОВАНИЕ МАСКИ ОБОЛОЧКИ 


Этот пример показывает, как найти соответствие текста с использованием 
масок, которые часто используются при работе с Ошх-оболочкой (напри- 
мер, *.ру, Да 0-9]*.с$у и т.д.). 


Для решения поставленной задачи мы используем модуль фптаёсВ, предо- 
ставляющий две функции — мтасй() и ттасйсазе(), которые могут ис- 
пользоваться для решения поставленной задачи. Использование функций 
очень простое: 


>>> Егом Ептаёср 1проге ЁЕпваесН, ЁЕпта&срсазе 
>>> Епшафсв ('герог*.+&хе', '*.&хе') 


Тгие 

>>> ЕптафсВ ('гер.ехе', '?оо.%х®') 

Еа1зе 

>>> Епмаесь ('Бафа45.сзу', 'Бафа[0-9]*') 
Тгие 
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>>> памез = ['РаЕ1.сзу', 'Ба2.сзу', 'сопйд.1п1', 'гер.ру'] 
>>> [паме Еог паме 1п памез 1Е Ептаесь(паме, 'ШБаф*.сзу')] 

[ "Раз: „сзм"“, "ваей. сх] 

>>> 


Шаблоны /птасй() используют те же правила, что и маски используемой 
файловой системы (которая зависит от используемой операционной систе- 
мы в свою очередь). Например: 


>>> # В 05 Х (Мас) 

>>> ЕптабсрВ ('гер.6хе', '*.ТХТ') 
Еа1зъе 

>>> # В И!паои5 

>>> Ептафср ('гер.6хе', '*.ТХТ') 
Тгкие 

>>> 


Если важен регистр символов, то используйте /итасйсазе(). Метод 
птасйсазе() различает строчные и прописные символы, которые вы пре- 
доставляете: 


>>> ЕптафсВсазе ('гер.%хе', '*.ТХТ') 
Еа1зе 
> 


Функциональность /итасй() находится где-то между функциональностью 
простых строковых методов и полной мощью регулярных выражений. Если 
вам нужно обеспечить простой механизм для разрешения подстановочных 
символов в операциях обработки данных, часто — это разумное решение. 


7.6.3. СОВПАДЕНИЕ ТЕКСТА В НАЧАЛЕ И КОНЦЕ 
СТРОКИ 


Пример показывает, как произвести поиск в начале и конце строки опре- 
деленного шаблона текста, например, расширение имени файла, название 
протокола и т.д. 


Самый простой способ заключается в использовании методов 5. а75щйй() 
и 5епазший(). Например: 


>>> Н1епаше = 'зрам.%х*' 

>>> Н1епаме.епЯАзм1 НВ ('.&х*') 
Тгае 

>>> Я1епаме. з$агезм1 РВ ('Я1е:') 
Еа1зъе 
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>>> иг1 = 'БЕЕр://мим.руЕВоп.ога' 
>>> иг1.звагезм1 В ('БЕЁр:') 

Ткое 

>>> 


Если вам нужно проверить на соответствие нескольким вариантам, про- 
сто предоставьте кортеж возможных вариантов функциям 5@а75йй() или 


еп ший(): 


>>> ипроге оз 

>>> Н1епамез$ = о$.11$91г('.') 

>>> Н1епамез 

[ 'Макен1е', 'ЁЕоо.с', 'раг.ру', 'зрам.с', 'зрам.П' ] 

>>> [паме Еог паме 1п Я1епамез 1Е паше.епазм1 В (('.с', '.Б')) 
] 

[о9:е", ’эрам. 6", "зрап. В" 

>>> апу (паме .епЧзм1В ('.ру') Еог паме 1п ВЯ1епапез) 

Ткое 

>>> 


7.6.4. ПОИСК ПО ШАБЛОНУ 


Довольно часто на практике возникает необходимость найти текст, соответ- 
ствующий определенному шаблону. Если искомый текст является простым 
литералом, чаще проще использовать базовые строковые методы, напри- 
мер, $.йп4(), 5епший(), эс яаптзший() и т.п. Например: 


>>> ЕехЕ = 'уеар, Бае по, Ба уеар, Ба по, Бае уеаь' 
>>> # Точное совпадение 

>>> ЕехЕ == 'уеаВ' 

Еа1зе 

>>> # Совпадение в начале или в конце 

>>> фехё.звагезм1Ъ ('уеаь') 

Тгое 

>>> фехЕ.епази1 В ('по') 

Еа1зе 

>>> # Поиск позиции первого вхождения искомого текста в строку 
>>> Еехё.йпа ('по') 

10 

>>> 


Для более сложного соответствия используйте регулярные выражения и 


модуль ге. Чтобы проиллюстрировать основную механику использования 


Ру{поп. Полное руководстто 999 [2 ру+поп 


регулярных выражений, предположим, что вы хотите найти даты, опреде- 
ленные как цифры, например, "03/19/2021". Вот как это можно сделать: 


>>> +ехЕ1 = '03/19/2021' 
>>> +ехЕ2 = 'Маг 19, 2021' 
>>> 


>>> парогЕ ге 
>>> # Простое соответствие: \4+ означает соответствие 1 или 
более цифрам 
>>> 1Е ге.табсь (г'\9+/\9+/\49+', +ехЕ!): 
. реапе('да') 
. е1 зе: 
. ргап('нет') 
да 
>>> 1Е ге.табсВ (г'\9+/\9+/\9+', +ехЕ?2): 
. рхгап*('да') 
. е1зе: 


. рх1п*('нет') 


нет 
>>> 


Если нужно выполнить больше соответствий, используя тот же образец, 
имеет смысл скомпилировать образец регулярного выражения в объект. 
Например: 


>>> Яакерае = ге. сотшр11е (г'\а+/\а+/\а+') 


>>> 1Е Чафера+к.тафксь (+ех+1) : 
. рг1пе('да') 
.. е1зе: 
.. Рг1пе('нет') 

да 

>>> 1Е Чаферак.тафксь (+ех+2) : 
. рат ('да') 
. е1 зе: 
. реап*('нет') 
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Метод тасй() всегда пытается найти совпадение в начале строки. Если вам 
нужно найти все вхождения, используйте метод дидаПО. Пример: 


>>> фехЕ = 'Сегодня 19/12/2021. Завтра 20/12/2021.' 
>>> аафера*.НпАа11 (+ех+) 

['12/19/2021', '12/20/2021'] 

>>> 


При определении регулярных выражений принято представлять группы 
захвата, заключая части образца в круглые скобки. Например: 


>>> ЧафераЕ = ге.сотр11е(г' (\а+) / (\а+) / (\9+) ') 
>>> 


Группы захвата часто упрощают последующую обработку соответствую- 


щего текста, потому что содержание каждой группы может быть извлечено 
индивидуально. Например: 


>>> ш = ааеера*.ютаесь ('12/19/2021') 

>>> м 

<_зге.5ВЕ Мафсн об)есЕ а® 0х100592750> 

>>> # Извлекаем содержимое каждой группы 

>>> ш.дкгочр (0) 

'12/19/2021' 

>>> ш.дгочр (1) 

"12 

>>> ш.дгочр (2) 

']19'! 

>>> ш.дгочр (3) 

'2021' 

>>> ш.дгочрв () 

(ое, 19, 202) 

>>> шопЕН, 4ау, уеаг = м.дгочрз () 

>>> 

>>> # Поиск всех соответствий 

>>> техЕ 

'Сегодня 12/19/2021. Завтра 12/20/2021. ' 

>>> даеера+*.Япаа11 (+ех+) 

Я то, '2021'), сам, 20", '2021') ] 

>>> Еог шоп, ау, уеахг 1п Чаеера*.бп4а11 (+ехе) : 
. ргап*('{}-{}-{}'.Еогта% (уеаг, шопеВ, ау) ) 


Ру!поп. Полное руководство ОИ руЕпоп 


2021-12-19 
2021-12-20 
>>> 


Метод дпааП(@) ищет текст и находит все соответствия, возвращая их как 
список. Если вы хотите найти соответствия итеративно, используйте метод 
Лпайето. Например: 


>>> Еог ш 1п Аафера*.Япа1+ег ($ех®): 
рг1п® (ш.дгочрз ()) 


('19*, "ТеК, #20213] 
(112, 120", 2024") 
>>> 


Обсуждение теории регулярных выражений выходит за рамки этой книги. 
Однако этот пример иллюстрирует абсолютные основы использования мо- 
дуля ге. Сначала нужно скомпилировать образец, используя те.сотрие(), а 
затем использовать методы, такие как таёсй(), лпааП() или Лпайего. 


При указании шаблонов, как правило, принято использовать обычные стро- 
ки, такие как г'(\4+)/(\4+)/(\а+)'. В таких строках обратный слеш остает- 
ся неинтерпретируемым, что может быть полезно в контексте регулярных 
выражений. Иначе вам придется использовать двойной обратный слеш, на- 


пример, '(\\9+)/(\\а+)/(\\а+)". 


Знайте, что метод тасй() проверяет только начало строки. Возможно, это 
немного не то, что вы ожидаете. Например: 


>>> м = ааеера* .мафсьЬ ('11/27/2021аъсаеЕ') 
>>> п 

< зхе.5ВЕ_МафсН об)есЕ а® 0х1005927е8> 
>>> ш.дгочр () 

"11/27/2021" 

>>> 


Если вам нужно точное совпадение, убедитесь, что шаблон в конце содер- 
жит маркер $, например: 


>>> Чаферае = ге. сошр11е (х' (\4+) / (\9+) / (\9+)$') 
>>> Чафера+*.мафсь ('11/27/2021аьсае=') 

>>> дафера*.мтаесь ('11/27/2021') 

<_зге.5ВЕ_Мафсп ою)есЕ а 0х100592750> 

>>> 
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Наконец, если вы просто выполняете простой поиск текста, вы можете ча- 


сто пропустить шаг компиляции и использовать функции уровня модуля в 
модуле ге вместо этого. Например: 


>>> ге.ЯпЯа11 (г' (\а+) / (\а+) / (\а+)', +ехЕ) 
ВСВ, ТО. 1202 САИ "Р0ь 2021”) | 
>>> 


Знайте, тем не менее, что если вы собрались произвести значительное соот- 
ветствие или поиск по большому тексту, обычно имеет смысл сначала ском- 
пилировать образец, чтобы использовать его снова и снова. Так вы получите 
значительный прирост производительность. 


7.6.5. ПОИСК И ЗАМЕНА ТЕКСТА 


В самых простых случаях используйте метод 5 тер[асе(). Например: 


>>> ЕехЕ = 'уеав, Боае по, Баё уеаБ, Бое по, Ба уеав' 
>>> Еехе.гер1асе('уеав', ‘'уер’) 

'уер, Раф по, Ба уер, Ба по, Баё уер' 

>>> 


Для более сложных образцов используйте функцию/метод 5и6() в моду- 
ле ге. В качестве примера представим, что нужно перезаписать даты вроде 
"11/27/2021" так, чтобы они выглядели так: "2021-11-27". 

Вот пример того, как это можно сделать: 

>>> ЕехЕ = 'Сегодня 11/27/2021. Завтра 3/13/2021.' 

>>> проге ге 

>>> ге.виЬ(г' (\а+) / (\а+) / (\а+)', х'\3-\1-\2', +ехЕ) 


'Сегодня 2021-11-27. Завтра 2021-3-13.' 
>>> 


Первый аргумент 5%6() - это шаблон, которой должен быть найден в тексте, 


а второй аргумент - это шаблон замены. Цифры с обратными слешами 
(например, \3) используются для группировки чисел в образце. 


Если вы собираетесь выполнить повторные замены с тем же образцом, за- 
думайтесь о его компиляции ДЛЯ лучшей производительности. Например: 


Рупоп. Полное руководство м в. ру1Поп 


>>> проге ге 

>>> Чаферае = ге.сотр11е(х' (\4+) / (\а+) / (\а+) ') 

>>> Чафера+ . зи Ъ (г'\3-\1-\2', ехЕ) 

'Сегодня 2021-12-19. Завтра 2021-12-20.' 

>>> 

Для более сложных замен можно использовать са!аск-функцию замены. 
Например: 


>>> Егош са1еп4аг 1трог® шоп аЪЬг 
>>> 4еЕ срапде_Да+е (м): 
.. Шоп паше = шопЕВ_ аЪЬг [11% (м.дгопр (1) ) ] 
гееигп '{} {} {}'.Еогма* (м.дгоцр (2), топ_пате, т.дгочр(3)) 


>>> дафера*. зчЪ (спапде_Чафе, +ехЕ) 
'Сегодня 19 Пес 2021. Завтра 20 Пес 2021.' 
>>> 


В качестве ввода в саПБаск-функцию замены передается объект, возвращен- 
ный функциями тасй() или дпа(). Используйте метод .втоир() для извле- 
чения определенных частей соответствия. Функция должна вернуть текст 
замены. 


Если вы знаете, сколько замен было сделано в дополнение к получению 
‘текста замены, используйте вместо этого 7е.5иби(). Например: 


>>> пемфехЕ, п = даферае. зиБп (г'\3-\1-\2', фехЕ) 
>>> пемфехЕ 

'Сегодня 2021-12-19. Завтра 2021-12-20. ' 

>>> п 

2 

>>> 


Для выполнения нечувствительных к регистру операций над текстом вам 
нужно использовать модуль ге и установить флаг ге. СМОКЕСАЗЕ. Этот 
флаг нужно устанавливать отдельно для каждой операции над текстом. 
Например: 


>>> фехЕ = 'ИРРЕВ РУТНОМ, 1омег ру®Воп, М1хеа Руевоп' 
>>> ге.йпЯа11 ('руфроп', +ехе, Яадз=ге. ТСМОВЕСАЗЕ) 
['РУТНОМ', "руброп', 'РУ&ПВоп' ] 

>>> ге.зчЪ ('руЕВоп', 'зпаке', +ехе, Яадз=ге. ТСМОВЕСАЗЕ) 
'ОРРЕВ зпаКе, 1омег зпаке, М1хеЯ зпаКе' 

>>> 
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Последний пример показывает ограничение, что текст замены не будет со- 


ответствовать регистру в исходном тексте. Если вам нужно исправить это, 
вам, возможно, придется использоватьфункцию поддержки, например: 


еЕ шафсьсазе (мога) : 
еЕ гер1асе (м) : 

фехеЕ = м.дгочр () 

1Е Еехе.1зиррег (): 
гефагп мога.пррег () 

е11{Е фехе.131омех (): 
геёагп мога. 1омег () 

е11Е +ехе[0].1зоррег (): 
гефогп могаА.сар1$а112е () 

е1зе: 


геёагп мога. 


гефогп гер1асе 


Вот пример использования этой последней функции: 


>>> ге. з\ч ('руЕВоп', тмафсЬсазе ('зпаКке'), +ехе, Яадз=ге. 
ТСМОВЕСАЗЕ) 

'ОРРЕВ 5МАКЕ, 1]омег зпаке, М1хеЯ бпаке' 

>>> 


7.6.6. УДАЛЕНИЕ НЕЖЕЛАТЕЛЬНЫХ СИМВОЛОВ ИЗ 
| СТРОКИ 


Часто требуется удалить нежелательные символы, например, пробелы в на- 
чале и конце строки. 


Метод 5$7р() может быть использован для удаления символов в начале или 
конце строки. Функции [57 р() или 75 "р() осуществляет обрезку символов 
слева или справа соответственно. 


По умолчанию эти методы удаляют пробельные символы, но вы можете за- 
дать любые другие символы. Например: 


Рупоп. Полное руководсто = №9 


>>> + Обрезаем пробельные символы 
>>> з = ' привет мир \п' 

>>> з.зЕг1р () 

'привет мир' 


>>> в.1з4к1р () 
‘привет мир \п' 
>>> з.гзЕгар () 
' привет мир' 
>>> 


>>> # Удаляем заданные символы 


>>> Е = '----- привет=====' 
>>> Е.13%:12р('-') 
'привет=====' 

>>> Е.зЕгар ('-=!) 

'привет' 

>>> 


Различные $&1р()-методы обычно используются при чтении и очистке дан- 
ных для дальнейшей обработки. Например, вы можете использовать их, 
чтобы избавиться от пробелов, удалить кавычки и выполнить другие зада- 
чи. Знайте, что 561р()-методы не применяются к любому тексту в середине 
строки. Например: 


>>> в = ' привет \п' 
>>> в = з.з6:1р() 
>>> 8 

'привет мир' 

>>> 


Если вам нужно сделать что-то во внутреннем пространстве, вам нужно ис- 
пользовать другую технику, например, использовать метод тер!асе() или 
замену с использованием регулярных выражений. Например: 


>>> з.гкер1асе(' ', '') 
'приветмир' 

>>> пирокЕ ге 

>>> ге.зоЬ('\з+', ' !', з) 
‘привет мир' 

>>> 
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Часто нужно объединить строковые операции разделения (5рЁ тг) с неко- 
торым другим видом итеративной обработки, например, чтение строк дан- 
ных из файла. Если это так, то вам пригодится использование генератора. 
Например: 


1 ореп(Я1епапме) аз Ё: 
131пез = (11пе.з6х1р() Еогк 11пе 1п Е) 
Еог 11пе зп 11пез: 


Здесь выражение Диез = (йпе.тр() ют [те т Г) действует как, своего рода, 
преобразование данных. Это эффективно, потому что оно, фактически, сна- 
чала не считывает данные в какой-либо вид временного списка. Мы 
просто создаем итератор, где все ко всем считанным строкам сразу приме- 
няется $ (). 


ГЛАВА 8. 


СПИСКИ 


8.1. Что такое список? 


Список — это нумерованный набор объектов. Каждый элемент набора со- 
держит только ссылки на объект. Именно поэтому список может содержать 
объекты произвольного типа данных и иметь неограниченную степень вло- 
женности. 


Списки поддерживают обращение к элементу по индексу (нумерация эле- 
ментов списка начинается с 0), получение среда, конкатенацию, повторе- 
ние, а также проверку на вхождение. 


Ранее было отмечено, что списки относятся к изменяемым типам данных 
(в отличие от кортежей). Это означает, что вы можете не только получить 
элемент по индексу, но и изменить его. Например: 


>>> 15 = Ш, 2, 3, 41 
>>> 13Е[1] 

2 

>>> 13Е[1] = 7 

>>> 156 


РуУпоп. Полное руко 


Создать список можно разными способами. Например, можно использовать 
функцию 45{(), которой нужно передать последовательность, по которой и 
будет создан список. Если вы ничего не передаете, будет создан пустой спи- 
сок: 


>>> 15Е = 115% ('Не11о') 
>>> 15Е 
Сер ТЕХ, ИТУ, 21. "0 ] 


Можно указать все элементы списка в квадратных скобках, как уже было 
показано. Обратите внимание, что элементы могут быть разных типов: 


>>> 15+ = а ни. 1] 
>>> 156 
маи “в, 1] 


Третий способ заключается в поэлементном формировании списка с помо- 
щью метода аррепё: 


>>> 136 = [] 

>>> 15Е.аррепа (1) 

>>> 156Е.аррепа (2) 

>>> 156Е.аррепа (3); 15% 
Ср оРя -В 

>>> 


ВРНР можно использовать такую конструкцию для добавления элементов 
в список: 


152[] = новый элемент 


В Руоп ее использовать нельзя, вы получите сообщение об ошибке. Также 
нужно быть осторожнее со следующей конструкцией: 


>>> а=Ь = ба", "Ь"] 


Как видите, при создании списка сохраняется ссылка на объект, а не сам 


объект. Поэтому нам кажется, что мы якобы создали два списка, а на самом 


деле обоим переменным была присвоена ссылка, указывающая на объект. 
Напомню, что проверить, ссылаются ли переменные на один и тот же объ- 
ект, можно с помощью оператора 1$, например (если оператор возвращает 
Тие, то переменные ссылаются на один и тот же объект): 


>>> а 13 Ь 
Тгае 


Если вам нужно создать вложенные списки, то это лучше делать с помощью 
метода аррепа(), например: 


>>> 136 = [] 

>>> Еог 1 1п гапде(3): 15®.аррепа ([]) 
>>> 15Е[0].аррепа (1) 

>>> 153% 


(1), [1, [)] 
>>> 


8.2. Операции над списками 


Над списками можно выполнить множество операций. Начнем с доступа к 
элементу, Для этого используются квадратные скобки ([]), в которых ука- 
зывается индекс элемента. Нумерация элементов списка начинается с 0. 
Примеры использования [] уже были показаны. 


Примечание. Поскольку нумерация элементов списка начинает- 
сяс 0, то индекс последнего элемента будет меньше на единицу 
количества элементов. 

Оператор присваивания можно использовать как для присваивания значе- 

ния всему списку, так и отдельному элементу: 

>>> 15 = [1 2, 3] 

>>> 15&[1] = 6 


В Руфоп 3 при позиционном присваивании перед одной из переменных 


слева от оператора = можно указать звездочку. В этой переменной 


Ру1поп. Полное руководство МО К. рупоп 


будет сохраняться список, состоящий из "лишних" элементов. Если таких 
элементов нет, то список будет пустым: 


>>> а, ю *е =; 2, 3, 4] 
Если вы попытаетесь получить доступ к несуществующему элементу, вм 
получите сообщение об ошибке таехЕтог: 


>>> 15Е[4] 
ТгасерасКк (позе гесепЕ са]11 1аз®): 
Е11е "<рузве11#39>", 110е 1, 1п <поди1е> 
15814] 
ТраехЕггог: 11$ 1паех ойф оЕЁ гапде 


В качестве индекса можно использовать отрицательные значения, в этом 
случае смещение будет отсчитываться с конца списка: 


>>> 15 =: р 9, 3, Ч 5, 6, 
>>> 15Е[-2] 
6 


Кроме обращения к элементу по индексу списки поддерживают операцию 
извлечения среза, которая возвращает указанный фрагмент списка: 


[<Начало> : <Конец> ;: <Шаг>] 


Все три параметра являются необязательными. Если не указан первый па- 
раметр, то используется значение 0. Если не задан второй параметр, то счи- 
тается, что нужно возвратить фрагмент до конца списка. Если не задан 
последний параметр, то используется значение 1. 


Операция среза очень интересная и мощная. Вот, например, как можно вы- 
вести элементы списка в обратном порядке: 


>>: 136[%#-1] 
[Убрал Ш 


Вот еще несколько примеров: 


>>> 138[:-1] # Без последнего элемента 


[1, 2, 3, 4, 5: 6] 

>>> 15Е[1:] $ Без первого элемента 
[2, 3; 4, 5 6, 7] 

>>> 13Е[0:3] # Первые три элемента 
П; 2; 3] 

>>> 13Е[-1:] # Последний элемент 
[9] 


Срез позволяет даже изменять элементы списка, например: 


>>> 15Е[1:3] 
>>> 15Е 
[1, 8, 9, 4, 5, 6, 7] 


| 
— 
со 
> 
<) 
ий 


Только будьте осторожны с этой операцией! 


Срез — это не единственная полезная операция над списком. Вы можете вы- 


полнить конкатенацию списков, используя оператор +: 


>>> 15% 

[1, 8, Ч 4, 5, 6, 7] 

>> 155 = 0, 1: 12 

>>> 153 = 156 + 1562; 13%3 


[Ли 3779, 4, э; 6; 7» 10% ДТ, 12] 


Если нужно добавить элементы в текущий список, можно использовать 


оператор +=: 


>>> 15% 

[1, 8, 9, 4, 5, 6, 7] 

>>> 13Е += [10, 11, 13]; 153% 

[12 8:9, 4:5 6, 7. 10а] 


8.3. Многомерные списки 


Любой элемент списка может содержать любой объект, в том числе и дру- 


ГОЙ список, кортеж, словарь и т.д. Вот как можно создать список, состоящий 


из трех списков: 


5 ае-= Ы : ЗЧ [аб ме], 19, 8, 


Рупоп. Полнсе руководство Иры. ру Поп 


>>> 15Е 
[[1, 2, 3], ['а', '5', 'с'], [9, 8, 7]] 


Чтобы добраться к элементам вложенного списка, нужно указывать два ин- 
декса, например: 

>>> 136[1] [2] 

т с т : 


В свою очередь элементы вложенного списка также могут быть списками 
и тд. Количество вложений не ограничено, поэтому у вас могут быть вот 
такие странные индексы: 


15 [1] [2] [31 [4]... 


Если того не требует решаемая задача, я бы не советовал увлекаться вло- 
женными списками -— так вы сделаете программу сложнее, чем она могла 
бы быть. 


8.4. Проход по элементам списка 


Вот как можно перебрать все элементы списка: 


>>> 15Е 

Се 2, З, а", Бр "ее, [9,8 7] 
>>> Еог 1 11 156: рг1п® (1, епа=" ") 

Нл ар За“ "5 6] 19; 8% 7] 
>>> 


Также для перебора списка можно использовать функцию тапёе(): 


гаподе ([<Начало>,] <Конец> [, <Шаг>]) 


Пример: 

>>> 15 = Пл 2, 3, 4] 

>>> Еог 1 1п гапае (1еп (1$%)): рг1п(1$6[1], епа=" ") 
2: 3:74 


о ВЕ 


Данный способ можно использовать не только для итерации по одномер- 
ным спискам, как вы бы могли подумать, например: 
Нео [9 8; 9] 


а 
$е)): ре1пЕ (1$6[1], епа=" ") 
9 Вл 


> Е = я ЗЧ” 
>>> Еог 1 11 гапде (1еп (1 
[1, Я; 3] а, "Би; 'с' 


В принципе, для перебора элементов списка можно использовать и цикл 
\ВИе, но обычно используется цикл фог, что и было продемонстрировано. 


8.5. Поиск элемента в списке 


Определить, есть ли элемент в списке, можно с помощью оператора 1, на- 
пример: 


>>> ЗЕ 
Пи. 2 Зи Га“ тв ме] 9, 8, 7] 
>> 2 ча 396 


Еа1зе 

2 15Е = Му 2, 3; 41 
>> Я чп. 156 

Тгце 


Как видите, данный способ не работает с многомерными списками, поэтому 
для поиска элемента в таких списках правильнее использовать перебор эле- 
ментов. Хоть медленно, но зато работает. 


Однако оператор Ш сообщает только, если ли элемент в списке, но он не 
сообщает его позицию. Для этого можно использовать метод шаех: 


>>> 156.1паех (3) 
2 


Здесь видно, что элементу 3 соответствует индекс 2. Если указанного эле- 
мента нет в списке, вы получите ошибку шеЕтог: 


>>> 15Е.1паех (7) 
Тгасераск (позе. гесепЕ са11 1а$%) : 
Е11е "<рузпе11#72>", 11пе 1, 1п <моаи1е> 
1$5Е.1паех (7) 
Уа1пеЕггог: 7 15 ПОЁ 11 1156 


Рупоп. Полное руководство и .... руфПоп 


Посчитать количество элементов с определенным значением позволяет ме- 
тод соип(): 


хор а: = И 9 9 
>>> 153Е.соопЕ (2) 

2 

>>> 13Е.со9пЕ (3) 

1 

>>> 156.сочпЕ (7) 

0 


Данный метод можно также использовать в качестве основного метода 
поиска элемента — если количество равно 0, то и элемента в списке нет. Вам 
не нужно обрабатывать никакие исключения, просто анализируйте количе- 
ство элементов и все. 


Функции тт() и тах() позволяют найти минимальный и максимальный 
элемент списка соответственно: 


>>: 15 = Пу 2-2, 3, Ш 
>>> шп (156); тах (156) 

1 

4 


8.6. Добавление и удаление 
элементов в списке 


Для добавления и удаления элементов создано множество методов. Начнем 
с метода арреп4(<объект>), позволяющего добавить элемент в конец спи- 
ска: 


>> ав =. [р 2, 9, 
>>> 156.аррепЧ (5) 
>>> 15% 


[1, 2, 3, 4, 5] 


Также добавить элементы в конец списка можно и с помощью оператора +=, 
например: 


>>> 136 += [6, 7] 
>>> 13% 
1, 2. 3, 4, 5 6, 7] 


Метод шзег&() вставляет объект в указанную позицию. Синтаксис следую- 
щий: 


1пзегк® (<индекс>, <объект>) 


Примеры: 
>>> 15 
То Зы Ая 555 67] 
>>> 15Е.1пзегЕ (0, 0) # Вставили ноль в начало списка 
>>> 156 
0, 2 2, 3, 4, 5; 6, 7] 
>>> 156.1п5егЕ (8, 8) # Вставили 8 в позицию 8 
>>> 15 
0, 1, 2, 3, 4, 5, 6, 7, 8] 


Для удаления элементов можно использовать методы рор(), гетоие() и опе- 
ратор 46]. Первый удаляет элемент с указанным индексом и возвращает 
его. Если индекс не указан, удаляется и возвращается последний эле- 
мент списка: 


[1, 2, 3, 4, 5, 6, 7] 
Оператор ав] ничего не возвращает, а просто удаляет элемент. Например: 


>>> Чет 15$%[6) 

>>>: 15 

1, 2, 3, 4, 5, 6] 
>>> 


Удалить элемент, содержащий определенное значение, можно с помо- 
щью метода 7етоие( ): 


>>> 15Е.кемоте (5) 
>>> 15Е 
Ра, а, 36] 


И 2 ручноп 
8.7. Перемешивание элементов и 
выбор случайного элемента 


Функция 5йиЛе() из модуля гап4от используется для перемешивания спи- 
ска случайным образом. Функция перемешивает сам список и ничего не 
возвращает. Пример: 


>>> парокгЕ гапаом 
>>> ЗЕ 

[р д 2, 

>>> гапаом. зпойе (1$%) 
>>> 156 

О р р Е 3] 

>>> 


Выбрать случайный элемент со списка можно с помощью функции сйо1се() 
из того же модуля: 


>>> гапаом.спо1се (13%) 
4 
>>> гапаом. сВо1се (1$%) 
2 


Изменить порядок следования элементов можно с помощью метода 


теиет5е(). В отличие от среза, данный метод работает с самим списком, а нес 
его копией: 


25> 19 

ДР а] 
>>> 156. геуехгсзе () 
>: а 
а, 8] 
>>> 


8.8. Сортировка списка 


Для сортировки списка используется метод $07(), синтаксис которого сле- 
дующий: 


зогЕ ([Кеу=Мопе] [, геуегзе=Ра1зе]) 


Оба параметра являются не обязательными. Метод изменяет текущий спи- 
сок и ничего не возвращает. Попробуем отсортировать список, используя 
параметры по умолчанию: 


ЭР ИЕ =. О. Эа Ур 9 бы А 
>>> 15.506 () 

>>> 15 

Ной д, 6: т 

>>> 


Для сортировки в обратном порядке укажите параметр геуеге=Тгие: 
>>> 15Е.зо0гЕ (геуегзе=Тгце) 

>>> 156 

[ и Га 6 Га Е. Га 4 а 3 2. 2 г 1 ] 


>>> 


Иногда нужно не учитывать регистр символов, для этого нужно вызвать 
507(() так: 


156.506 (Кеу=зег. 1омег) 


Помните, что метод 507 () изменяет список, а в некоторых случаях этого не 
нужно делать. Для таких случаев предназначена функция $ог(е4(): 


зогсеч (<Последовательность>[, Кеу=Мопе]|[, геуегзе=Га1$е]) 
Первый параметр - это последовательность, которую нужно отсортировать, 


остальные параметры - такие же, как у метода 507(). Данная функция 
возвращает отсортированный список и не изменяет исходный. 


8.9. Преобразование списка в строку 


Для преобразования списка в строку используется метод /0т(). Вызывать 
его нужно так: 


<Строка> = <разделитель>.)о1п (<последовательность>) 
Пример: 

>>>. 15. = [БЫ "ее"; "1; 1, 10" 

о вс -=: Аша (5) 

>>> 3 

'ре11о' 


РУПоп. Полное руководство О #2: ру{Поп 


Здесь в качестве разделителя мы используем пустую строку, поэтому, по 
сути, разделителя нет. 


8.10. Вычисления с большими 
числовыми массивами 


МитРу!' — основа для огромного числа научных и технических библиотек 
Рупоп. Но в то же время МитРу - один из самых больших и самых слож- 
ных в использовании модулей. Однако вы можете выполнить полезные 
вещи с МитРУ, начиная с простых примеров и экспериментируя с ними. 


Нужно сделать только одно примечание относительно использования 
МитРу Относительно распространено использовать оператор 1птроге 
потру аз пр, что и показано в далее. Это просто сокращает название моду- 
ля - так удобнее, если часто приходится обращаться к нему. 


Представим, что вам нужно произвести вычисления с огромными число- 
выми наборами данных, например, с массивами или сетками (таблицами). 


Для любых "тяжелых" вычислений с использованием массивов нужно ис- 
пользовать библиотеку МитРУу. Основное назначение МитРУу - то, что она 
предоставляет Ру{Воп объект массива, который более эффективен и луч- 
ше подходит для математических вычислений, чем стандартный список 
Руфоп. Вот небольшой пример, иллюстрирующий важные поведенческие 
различия между массивами МитРУу и списками: 


>>> # Списки РУЕПоп 
>>> а = [2, 2,2, 2] 
>>> Ь = [3, 3, 3, 3] 
>>> а* 2 


[2, 2, 2, 2,2, 2,2, 2] 
>>> а + 10 
Тгасераск (мозф гесепе са]11 1аз®): 
Е11е "<рузве11#115>", 11пе 1, 1п <моаа1е> 


а + 10 
ТуреЕггог: сап оп1у сопсабепафе 1156 (поЕ "1пе") Фо 1136 
>>> а+ Ьь 
[2, 2, 2, 2, 3, 3, 3, 31] 


>>> 


>>> # Массивы №тру 
>>> дироге питру аз пр 


1  Бер:/Имммлитру.огя 


>>> ап = пр.аггау ([2, 2, 3, 3]) 

>>> рп = пр.агкау ([5, 5, 7, 7]) 

>>> ап * 2 

аггау ([4, 4, 6, 6]) 

>>> ап + 10 

аггау([12, 12, 13, 13]) 

>>> ап + рп 

аггау([ 7, 7, 10, 12]) 

>>> ап * рп 

аггау([ 10, 10, 21, 31]) 

>>> 

Как видите, основные математические операции с массивами ведут себя 
иначе. В частности, скалярные операции (например, ап * 2 или п + 10) 
применяются к массиву поэлементно (в случае с обычным списком нужно 
было писать цикл и добавлять в цикле 10 к каждому значению списка). Кро- 
ме того, математически операции, когда оба операнда являются массивами, 
применяются к каждому элементу и в результате создается новый массив. 


Библиотека МатРу предоставляет набор "универсальных функций", кото- 
рые также доступны для работы с массивами. 


Данные функции представляют собой замену обычных функций, которые 
вы можете найти в модуле та. Например: 


>>> пр.зак® (ап) 
аггау ([1.41421356 ‚, 1.41421356, 1.73205081, 1.73205081 1) 
>>> пр.соз (ап) 
аггау ([-0.41614684, -0.41614684, -0.9899925 , -0.9899925]) 


>>> 


Использование универсальных функций может быть в сотни раз быстрее, 
чем перебор массива в цикле поэлементно и выполнение необходимых опе- 
раций над каждым элементом отдельно. Поэтому если вам нужно выпол- 
нить операции с использованием функций из модуля та над элементами 
массива, взгляните на аналогичные функции модуля пр. Вы должны пред- 
почесть их; если это возможно. 


"За кулисами" массивы МитРу выделяются таким же способом, какив С 
или Еогёгап. А именно они являются большими, непрерывными областями 
памяти, состоящие из однородного типа данных. Именно поэтому вы мо- 
жете сделать массивы просто огромными, гораздо больше, чем вы себе мо- 
жете представить. Например, если вы желаете сделать двумерную таблицу 
10 000х 10 000, состоящую из чисел с плавающей запятой, это не проблема. 


Рупоп. Полное руководство О @: руЕПоп 


>>> дг1а = пр.гегоз (зБаре= (10000,10000), аЕуре=йоа+) 


>>> дг1а 

акад Оси, Ол 0:, вы 9, 0, 0.1, 
[ 0., 0 Й 0., ’ 0., 0 7 0 ]; 
05, бь, 05; и 0: 0; , 
оО, Ох чб ее 0, О ЭТ: 
[оби О, О, гр Ю- Эр Фе 
Е ‘0%; 0,1055 ст бр би 0 

>>> 


Все обычные операции все еще применяются ко всем элементам одновре- 
менно: 


>>> дг1а += 100 


>>> дг1а 

аткау ([[ 100.» 1005, 100:, -..-„ 100, 100.) 100, 
[7100.;;. 2005, 100: 5х» 100, 1090.:, 100, 
100, ОО, 4005, ззьь 100, 100, 1003], 
[ 100.,„. 100%, ТОО,» 100, 100, 2001, 
[ 100.,„ 100., 100.5; за, Об, 100. 100], 
[ 100,290, 190%, „-- 100.» 100..,, 100) 


Один чрезвычайно известный аспект М№итРу — способ, которым она рас- 
ширяет список Ру оп, индексирующий функциональность — особенно 
при работе с многомерными массивами. Чтобы проиллюстрировать это, 
сделайте простую двумерную матрицу и попробуйте выполнить некоторые 
эксперименты: 


>>> а = пр.аггау ([[1, 2, 3, 4], [5, 6, 7, 8], [9, 10, 11, 12]]) 


>>> # РЯд 0 
>>> а[1] 
аква [Ти 2х 8, 4) 


>>> # Колонка 1 
>>> а[:,1] 
аквау (2, 6, 101) 


>>> #4 Выбираем фрагмент массива и изменяем его 


Фе 


>>> а[1:3, 1:3] 
аггау([[ 6, 7], 


[10, 1111) 
>>> а[1:3, 1:3] += 10 
>>> а 
аггау ( [ ‚2, 3, 4}, 


ЁЯ 
а Е: 
Е 


8.11. Программа "Гараж 


Теория — это хорошо. Теперь продемонстрируем полученные знания на 
простом примере, который оформлен в виде листинга 8.1. 
Листинг 8.1. Проход по списку автомобилей 


сагз = ["апа1", "ум", "1ехоз"] 
рг1пе ("Наши машины: ") 
вое авем тп сае8“ 

ре1 пе (1$ ем) 


К списку можно применять функцию |еп(): 


сагз = [ааа АМ "Зехиз"., "а", "то" ] 
рг1пе ("Всего ", 1еп(саг$), " машин (ы) в гараже") 


Вывод программы: 
Всего 5 машин (ы) в гараже 
Оператор 11 можно использовать для поиска по списку. Рассмотрим не- 
большой пример: 
сагз = Саманеие, "А", "1ехи&", ЧЕХ", "9" 
саг = 1приф ("Введите название авто: ") 
Е ‘са ато сака: 
рг1п® ("У вас есть авто из списка!") 


е15е: 
рг1пе ("У вас нет машины из списка :(") 


Вывод программы: 


Введите название ато: ум 
У вас нет машины из списка: ( 


Зинин неимением няни ини жи ини ини мниних 


РУпоп. Полное руководство 


Введите название авто: уч 
У вас есть авто из списка! 


Как уже было сказано, списки индексируются. Ничего нового нет. Индек- 


сация начинается с 0 (то есть первый элемент списка имеет индекс 0), под- 
держиваются положительные и отрицательные индексы. 


Пример работы с индексами: 


сагз = ава”; "ум", "]ехиз", елей "п5"} 
эзсакЕ = -1еп (саг$) 
еп = 1еп (сагз$) 


Еог 1 1п гапае (з6аге, епа, 1): 
рЕТПЕ("сакз[", 2, "| = "ях саг$[1]) 


Вывод программы: 


сагз[ -5 |] = аца1 
сагз[ -4 ] = ум 
сагз[ -3 ] = 1ехаз 
саеё[ =? ]:= ЗЕЕ 
сак5[ -1 ] = 15 
сагз[ 0 ] = аца1 
сагз[ 1 ] = \м 
сагз[ 2 ] = 1ехаз 
саг5[ 3 ] & “ЕЕ 
сагз[ 4 ] = 15 


Сначала мы получаем начало (-|еп()) и конец (]еп()) диапазона. Потом про- 
ходимся по списку и указываем в качестве индекса переменную 1, которая 
изменяется от 527 до епа с приростом в 1. 


Из вывода видно, что первому элементу списка присвоен индекс 0. Также 
к нему можно обратиться по индексу -еп(саг$), который в нашем случае 
равен -5. 


Теперь мы можем приступить к разработке самой программы "Гараж". 
Программа Гараж демонстрирует практически все операции над списком: 


» Добавление и удаление элементов 
® Вывод списка 


® Сортировка списка 


И 


® Поиск элемента в списке 


Листинг 8.2. Программа Гараж 


сагз = [1] 

рЕЧАЕ( "= 10;,.“ гараж бен. "а и" 10) 

гезропсе = 1 

\р11е гезропсе: 

рг1пё ("""Выберите действие: 

1 - Добавить авто 
2 - Удалить авто 
3 - Вывести список авто 
4 - Поиск 
5 - Сортировка гаража 
@.— Вод") 


гезропсе = 1106 (1приё (">> ")) 

1Е гезропсе == 
саг = 1при® ("Новое авто: ") 
саг$ .аррепа (саг) 

е11Ё гезропсе == 


саг = 1при® ("Удалить авто: ") 
саг$ .гемоте (саг) 

е11Е гезропсе == 3: 
рг1п® (саг$) 

е11Ё гезропсе == 4: 


саг = 1приё ("Поиск: ") 
1Е сах ап -сакза 
рг1п® ("Такая машина есть в гараже!") 
е15е: 
рг1п® ("Нет такой машины в гараже!") 
е11Е гезропсе == 
сах5.вох 0) 
рг1п ("Отсортировано!") 
е15е: 
рг1п® ("Пока!") 


Программа работает так. В цикле мы выводим подсказку-меню. Пользова- 


тель вводит свой выбор, программа выполняет действия в зависимости от 
введенного номера действия. Предполагается, что пользователь будет вво- 
дить только цифры от 0 до 5. Обработка некорректного ввода не добавля- 
лась для упрощения кода. 


ГЛАВА 9. 
КОРТЕЖИ 
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Кортежи — это еще один из типов последовательностей. Но в отличие от 
строк, которые состоят только из символов, кортежи могут содержать эле- 
менты любой природы. В кортеже вы можете хранить, например, фами- 
лии сотрудников, марки автомобилей, номера телефонов и т.д. 


Самое интересное, что элементы кортежа не обязательно должны относить- 
ся к одному типу. При желании вы можете создать кортеж, содержащий, как 
строковые, так и числовые значения. Вообще кортеж может содержать все, 
что угодно — хоть звуковые файлы. 


9.1. 


1онятие кортежа 


В отличие от списка, кортежи относятся к неизмепясмым типам данным. 
Это означает, что вы можете получить документ по индексу, но не можете 
его изменить. Небольшой пример, чтобы вы понимали, о чем речь: 


>> вар = 1, 2, 3, № 
>>> Гар[2] 
З 
>>> Еар[2] = 5 
ТгасерасКк (тмозф гесепЕ са11 1а3%): 
Е1]е "<рузЬе11#2>", 11пе 1, 1п <поал1е> 

ав [2] = 5 
ТуреЕггог: '6ар1е' ор)]есф аоез по зирроге 1$еш азз1аптепе 
>>> 


Рупоп. Полное руководство ОО ®: рупоп 


Как видите, при попытке присвоить новое значение элементу кортежа, мы 
получили сообщение о том, что кортежи не поддерживают присваивание 
значения элементу. 


Кортежи, как и списки, являются упорядоченными последовательностя- 
ми элементов. Во многом кортежи похожи на списки, разве что их только 
нельзя изменить. Грубо говоря, кортеж - это список, доступный "только для 
чтения". 


9.2. Создание кортежей 


Создать кортеж можно несколькими способами. Первый способ был уже 
нами рассмотрен - это перечисление элементов внутри круглых скобок че- 
рез запятую, например: 


Сар = () # Создан пустой кортеж 

Бир = (1,) # Кортеж из одного элемента 

Фар = (1, 2, 3) # Кортеж из трех элементов 

фир = (1, "5х", 3) # Кортеж из трех элементов разного типа 


Также можно использовать функцию #ир[е(), которая преобразует передан- 
ную ей последовательность в кортеж. Пример: 


фир = &ир1е() #$ Пустой кортеж 
фор = бар1е ('Не11о') $ Преобразуем строку в кортеж 
фир = &ар1е([1, 2, 3]) $ Преобразуем список в кортеж 


Вообще-то кортеж формируют запятые, а не круглые скобки. Скажем, вы 
можете создать кортеж так: 


2 =, Я 3 
>>> фар 
2, 


Позиция элемента в кортеже задается индексом. Нумерация элементов на- 
чинается с 0 (как и в случае со списком). Как и все последовательности, 
кортежи поддерживают обращение к элементу по индексу, получение среда, 
конкатенацию (+), проверку на вхождение (т) и повторение (*). Рассмо- 
трим несколько примеров: 


>» Бир = (и Ру Зл 4, р) 
>>> Еар[4] # доступ по индексу 
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5 

>25. Заре] # обратный порядок 
(5, 4, 3, 2, 1) 

>>> 1ир[2:3] # срез 

(3,) 

>>>: р] # еще срез 

(2, 3) 

>>> 7 ап р # проверка на вхождение 
Еа1зе 

>>> 2 1п р 

Тгае 

>>> тир * 2 # повтор 


О а о 

>>> Гар + (1, 2, 4) # конкатенация 
(Тех Зя д, 9 ПЕ 2.) 

>>> 


Примеры ранее были рассчитаны на интерактивную работу с ТОГЕ. Теперь 
посмотрим, как можно создать кортеж в РуВоп-файле: 


сагз = ("М№13ззап", "Тоуофа", "Цехиз") 
ЯАг1\уегз$ = () # Создает пустой кортеж 


Первая строка создает непустой кортеж, состоящий из трех элементов. Вто- 
рая строка создает пустой кортеж. 


9.3. Методы кортежей 


Кортежи поддерживают всего два метода: 


1раех (<Значение>[, <Начало>[, <Конец>]]) 
соипЕ (<Значение>) 


Первый метод возвращает индекс элемента с указанным значением. Если 
такого элемента нет в кортеже, то генерируется исключение УаеЕггог. 
Если не заданы второй и третий параметры, то поиск будет производиться 
с начала кортежа. 


>>> фир = (1, 2, 3, й, 6,2, 7) 
>>> Еир.1паех (2) 

3. 

>>> Еир.14ех(2, 2) 


РУПоп. Полное руководство 999 ее #2: рутноп 


Второй метод подсчитывает количество элементов в кортеже с указанным 
значением: 


>>> Еар.соопЕ (2) 
2 


Чтобы не обрабатывать исключение Уа]меЕггог, проверяйте сначала коли- 


чество элементов методом соип(() - если оно отличное от 0, тогда вычис- 
ляйте позиции элементов методом таех(). 


Других методов у кортежей нет, но вы можете использовать функции, пред- 
назначенные для работы с последовательностями. 


9.4. 


еребор элементов кортежа 


Вывести содержимое кортежа можно функцией ритЕ(): 
рг1пе (сагз$) 
Перебрать все элементы кортежа и что-то сделать с ними: 


Еог 16ем 1п сагз: 
рг1 п (16ем) 


9.5. Кортеж как условие 


Кортеж можно использовать как условие, например: 


те мое. ваше 
рг1пе ("У вас нет машины!") 


Пустой кортеж интерпретируется как ложное условие (Ра{5е), а кортеж, со- 
держащий хотя бы один элемент - как истинное. Поскольку пустой кортеж 
интерпретируется как Рае, то условие по саг$ оказывается истинным, 
поэтому программа выведет строку "У вас нет автомобиля". 


9.6. Функция !еп() и оператор т 


К кортежам может применяться функция [еп(), возвращающая число эле- 
ментов кортежа: 
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рг1пё ("Всего машин: ‚ Т1@п(сагз)) 
Проверить существование элемента в кортеже можно так: 


ТЕ "М эзап" п. баг5: 
рг1пе ("У вас есть М№155ап!") 


9.7. Неизменность кортежей и 
слияния 


О кортежах вам нужно знать еще две вещи. Первая - они, как и строки, не- 
изменяемые: 


2». сага: =. ("“итбзан“ и “ЕО ва!) 
>>> ргтпЕ (саг$[0]) 

101$5ап 

>>> сагз[0] = "Рога" 


Тгасебаск (щоз® гесеп® са11 1аз®): 
Е11е "<рузВе11#5>", 11пе 1, 1п <поаи1е> 
сагз[0] = "Еока" 
ТуреЕггог: '6ир1е' оБ]есе аоез поЕ зиррог® 1%ем аз51аптепе 
>>> 


То есть вы не можете присвоить другое значение элементу кортежа. 


Вторая вещь — кортежи поддерживают слияния. Слияние кортежей еще на- 
зывают сцеплением. Чтобы выполнить сцепление кортежей, нужно исполь- 
зовать оператор +. 


9.8. Модуль Неноо!$ 


Модуль Цегеоо]5 содержит функции, позволяющие генерировать различ- 


ные последовательности на основе других последовательностей, произво- 
ДИТЬ фильтрацию элементов и др. Подключить модуль можно так: 


1тпроге 16ег®оо15$ 


Рупоп. Полное руководство а. ру{Поп 


Далее можно использовать функции этого модуля. Начнем с функции 


соип((), которая создает бесконечную нарастающую последовательность. 
Синтаксис: 


сочпЕ ([з6ахгё=0] [, зЕер=1]) 
Первый параметр задает начальное значение, а второй — шаг. Пример: 


>>> 1арогЕ 1Еег6Еоо1$ аз 1 
>>> Еог 1 1п 1&.соипЕ(): 
1Е 1 > 15: ргеак 
рг1пё (1, епа=" ") 


01: 23456439 10 11 12 13.44.15 


Просто так вызвать соип() вы не можете, поскольку функция создает бес- 
конечную последовательность и вы получаете бесконечный цикл. 


Функция тереа/() возвращает объект указанное количество раз. Функции 
передаются два параметра — объект и количество повторений. Если коли- 
чество повторений не указано, то объект будет возвращаться бесконечно. 
Пример: 


>>> 115% (16.гереа®('*', 10)) # Список из '*' 
А 1х! тхт! тх': 1х! 9х! а, тх! тхт! Я 
7 ’ + 7’ ' , (а 7’ + 


# Комбинация функций 21р() и гереа* () 
>>> 1156 (21р(1Е.гереа® (3), "абс")) 
РЗ ка) к За Вр ((З 6) 

>>> 


В предыдущем примере для создания комбинаций мы использовали функ- 
ЦИЮ 271р(), которая не является частью Цегбоо[5, но в самом модуле Цег(оо]$ 
есть подобная функциональность: 


>>> 1154 (1е.сопю1пае1оп$ ('аБс', 2)) 
оба оао, п 


Функция сотбтайоп$_ший_терасетепКиета Ме, г’) создает комбинации 
длиной г из НегаЫе с повторяющимися элементами. Пример: 


>>> 115% (1Е.сошю1паЕ1оп$ м1 _гер1асемепе ([1,2,3], 2)) 
[(1, 1), (1, 2), (1, 3), (2, 2), (2, 3), (3, 3)] 
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Для создания перестановок используется функция регтщайоп5(): 


>>> 1136 (16.регмаба®1опз ('арс', 2)) 
Воаа Зо) (ам, че, сви, ба’ 5, бе) (6, ‘ам, 
(Те; 6 ).-.] 


Функция сусе(Йета е) — возвращает по одному значению из последова- 


тельности, повторенной бесконечное число раз. 


Функция сйат(*йета 5) — возвращает по одному элементу из первого ите- 
ратора, потом из второго, до тех пор, пока итераторы не кончатся. 


Функция (оршйие(ритс, петаШе) возвращает элементы йета МЕ, начиная с 
первого, для которого Ёлпс вернула ложь. Пример: 


>>> 1156 (1Е.Агормр11е (1апрада х: х < 5, [1,4,6,4,1])) 
(6). 4; а] 
>>> 


Функция (ее(йета Е, п=2) создает кортеж из п итераторов: 


16.сее ([1,2,3,4], 2) 

(<1{егЕоо15._6ее ордесе аб 0х04756558>, <1{ег&оо13. {ее обдесе 
аЕ 0х04756508>) 

>>> 


Модуль Цегбоо[$ очень удобен, когда нужно создать перестановку, комби- 
нацию. В этом случае не нужно изобретать колесо, а использовать функции 
модуля Цегбоо!5. 


9.9. Распаковка кортежа в отдельные 
переменные 


Представим, что у нас есть кортеж из М элементов, который вы хотите "рас- 
паковать" в набор из М переменных. 


Любая последовательность может быть распакована в переменные с ис- 
пользованием простой операции присваивания. Требование только одно: 
чтобы число переменных соответствовало числу элементов в структуре. 
Например: 
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>>> р = (4, 5} 
>>> х, у=р 
>>> х 

4 

>>> у 

5 

>>> 


>>> Аафа =. | "Беп", 50; 91:1, (2022, 12; 23 
>>> паше, зпагез, рг1се, Чафе = аафа 

>>> паме 

'реп' 

>>> даже 

(2022, 12; 21) 

>>> памше, зрагез, рг1се, (уеаг, шоп, Чау) = Чафа 
>>> паме 

'Реп' 

>>> уеаг 

2022 

>>> шоп 

ТР 

>>> аау 

21 

>> 


Если будет несоответствие в числе элементов, то вы получите ошибку. 
Например: 
>>> р = (4, 5) 
>>> ху д=р 
ТгасебасКк (тоз® гесепЕ са11 1аз%): 
Е11е "<5%41п>", 11пе 1, 1пл <поао1е> 
Уа1оеЕггог: пееа поге +КВап 2 уа1аез Фо пипраск 
>>> 


Фактически, распаковка работает с любым объектом, который является 


итерируемым, а нетолько с кортежами или списками. К таким объектам от- 
носятся строки, файлы, итераторы и генераторы. Например: 


>>> $з = 'Не11о' 

>>> а Ь, с а, е=з 
>>> а 

"Н' 

>>> Ь 
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'о' 
>>> 


При распаковке иногда бывает нужно отбросить определенные значения. 


У Ру{Поп нет специального синтаксиса для этого, но вы можете просто ука- 
зать имя переменной для значений, которые нужно отбросить. Например: 


>>> Часа = [ "Вёл", 50, 91.1, (2022, 12, 2) |] 
>>> _, зрВагез, рг1се, _ = дафа 

>>> эзВагез 

50 

>>> рг1се 

91.1 

>>> 


Однако убедитесь, ЧТО ИМЯ переменной, которое вы выбираете, не исполь- 


зуется для чего-то еще. 


Ситуация усложняется, когда вам нужно распаковать М элементов из ите- 
рируемого объекта, который может быть длиннее, чем М, что вызывает ис- 
ключение "оо тапу саме; ю ипрасЁ". 


Для решения этой задачи может использоваться "звездочка". Например, 
предположим, что в конце семестра вы решаете отбросить первые и послед- 
ние классы домашней работы и выполнить только их среднюю часть. Если 
классов только четыре, то можно распаковать все четыре, но, что если 24? 
Тогда все упрощает "звездочка": 


ЧеЁ Чгор_Нгз®_1аз+ (дгааез) : 
НгзЕ, *п1Аа1е, 1азЕ = дга4ез 
гебигп ауд (п1941е) 


Рассмотрим и другой вариант использования. Предположим, что у вас есть 
записи, состоящие из имени пользователя и адреса электронной почты, 
сопровождаемые произвольным числом телефонных номеров. Вы можете 
распаковать эти записи так: 


>>> гесога = ('МагКк', 'магКк@п1.сепфек', '25-333-26', '888-12-11') 
>>> памше, ета11, *рпопе пашрегз = чзег гесога 

>>> паме 

'Макк' 
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>>> ета11 

'пахк@п1е.сепфег" 

>>> рпопе пипегз 
['25-333-26', ''888-12-11'] 
>>> 


Стоит отметить, что переменная рпопе_питьегз всегда будет списком, неза- 
висимо от того, сколько телефонных номеров распаковано (даже если ни 
один). Таким образом, любой код, использующий рБопе_питьегз, должен 
всегда считать ее списком или хотя бы производить дополнительную про- 
верку типа. 


Переменная со звездочкой может также быть первой в списке. Например, 
скажем, что у вас есть последовательность значений, представляющая объ- 
емы продаж вашей компании за последние 8 кварталов. 


Если вы хотите видеть, как самый последний квартал складывается в сред- 
них по первым семи кварталам, вы можете выполнить подобный Код: 


*Ега111п9 аегз, сигкепе аег = за1ез _гесога 
{га111п49_ ауд = зим (&га111па аегз) / 1еп ({га111п9 аегз) 
тесигп ауд _сотраг1зоп (ха111п4а ауд, сикгепе аёг) 


А вот как выглядит эта операция из интерпретатора Руоп: 


>>> ера ис... сциввае- = [10 8, 1, 1, 92455, 10, 9 
>>> {га111п9 

ча 9 сы ВОЙ 

>>> сиггкепЕ 

3 


Расширенная распаковка итерируемого объекта нестандартна для распа- 


ковки итерируемых объектов неизвестной или произвольной длины. Часто 
у таких объектов есть некоторый известный компонент или образец в их 
конструкции (например, "все, что после элемента 1 считать телефонным но- 
мером”) и распаковка со звездочкой позволяет разработчику усиливать те 
образцы, чтобы получить соответствующие элементы в итерируемом объ- 
екте. 


Стоит отметить, что *-синтаксис может быть особенно полезным при ите- 
рации по последовательности кортежей переменной длины. Например, 
возможно у нас есть последовательность теговых кортежей: 
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4еЁ 4о Еоо(х, У): 
рг1пе ('Еоо', х, У) 


аеЁ ао раг(5): 
рг1пе ('рах', $) 


Еог ад, *ага5 1п гесогаз: 


1Е Еаа == 'Еоо'; 
ао_Еоо(*агдз) 
е11Е фаз == "'Баг': 


4о_Ъахг (*аг95) 


Распаковка со звездочкой может также быть полезной, когда объединена с 
определенными видами операций обработки строк, например, при разделе- 
нии строки (5р тв). Например: 


>>> пе = 'породу:*:-2:-2:Опрг1уедеа Озег: /уаг/епр®у: /изг/Б1п/Еа1зе' 
>>> опаше, *Не1аз, ромеЯ1г, зр = 11п0е.3р116(':'). 

>>> ппаме 

'пороау' 

>>> Вомеа1г 

'/уаг/епреу' 

>>> зв 

'/озг/Ю1п/Еа1зе' 

>>> 


Иногда нужно распаковать значения и отбросить их. Вы не можете указать 
пустое место с * при распаковке, но вы можете использовать звездочку 
вместе с переменной _. Например: 


>>> гесога = ('Реп', 50, 123.45, (17, 03, 2021)) 
>>> паме, *_, (*_, уеаг) = гесога 

>>> паме 

'Реп' 

>>> уеаг 

2021 

>>> 
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Есть определенная схожесть между звездообразными функциями распа- 
ковки и обработки списков различных функциональных языков. Напри- 
мер, если у вас есть список, вы можете легко разделить его на компоненты 
головы и хвоста. Например: 


>>> 1Еемзё = [1, 10, 7, 4, 5, 9] 
>>> реа, *{фа11 = 1%&емз 

>>> Неаа 

1 

>>> {а11 

[10, 7, 4, 5, 9] 

>>> 


Можно было предположить написание функций, выполняющих такое раз- 
деление, в виде некоторого умного рекурсивного алгоритма. Например: 


>>> аеЕ зип (1%етз) : 

... ВеаЯ, *фа1]1 = 1%емз 

... гебагп Веаа + зим (%$а11) 1Е {а11 е1зе Беаа 
>>> зим (1$етз) 

36 

>>> 


Однако знайте, что рекурсия действительно не сильная функция Ру{Воп из- 


за свойственного ей предела. Таким образом, этот последний пример приве- 
ден только из академического любопытства, на практике вы вряд ли будете 
использовать рекурсию в РуШфоп. 


9.10. Списки у$ кортежи 


Мы только что рассмотрели, как работать с кортежами в Руоп. Возникает 
закономерный вопрос - когда лучше использовать списки, а когда — кор- 
тежи? Понятно, что списки — лучше кортежей, поскольку можно изменять 
элементы списка. 


Но не спешите отказываться от кортежей. У них есть следующие преиму- 
щества: 


® Кортежи работают быстрее. Система знает, что кортеж не изменится, 
поэтому его можно сохранит так, что операции с его элементами будут 
ВЫПОЛНЯТЬСЯ быстрее, чем с элементами списка. В небольших программа 


©: рукой Глава 9. Кортежи 


эта разница в скорости никак не проявит себя. Но при работе с больши- 
ми последовательностями разница будет ощутимой. 


е Неизменяемость кортежей позволяет использовать их как константы. 


® Кортежи можно использовать в отдельных структурах данных, от кото- 
рых Руоп требует неизменимых значений. 


е Кортежи потребляют меньше памяти. Рассмотрим пример: 


ха = (2, 94, 5 
>>> В = |1, 24, 3, 4,35, 6] 
>>> а. _з12еоЕЁ () 

36 

>>> Ь.__з12еоЕ __() 

44 


® Кортежи можно использовать в качестве ключей словаря: 


>а=Ч 1 Ш 
>>>а 
Е Ш, Зе 
>> аз, Ш] 
ТгасерасКк (мозЕ гесепЕ са1]1 1аз®) : 
Ее "",: 1ае 1, 1 
= о 


ТуреЕггог: ипрВазраЬ]1е $уре: '115%' 
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МНОЖЕСТВА И СЛОВАРИ 
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10.1. Понятие словаря 


Словарь -— это набор объектов, доступ к которым осуществляется не по ин- 
дексу, а по ключу (аналог ассоциативных массивов в РНР). Словари могут 
содержать данные разных типов и иметь неограниченную степень вложен- 
ности. 


Элементы в словарях находятся в произвольном порядке. Для доступа к 
элементу нужно использовать ключ, нет никакого способа обратиться кэле- 
менту в порядке добавления. 


Словари, как тип данных, относятся не к последовательностям, а к отобра- 
жениям. Именно поэтому операции, которые были применимы к последо- 
вательностям (конкатенация, повторение, срез и т.д.), к словарям не при- 
менимы. 


Существует несколько способов создания словаря. Первый способ - это 
использование функции (4: (). 


Я1се (<Ключ1>=<Значение1>[,.., <КлючМ№>=<Значение\>] 
Я1с+ (<Список кортежей с двумя элементами - Ключ и Значение>) 
Ч1с® (<Список списков с двумя элементами - Ключ и Значение>) 


Рупоп. Полное руководство ООО [5 рутпоп 


Рассмотрим несколько примеров: 


>>> а = а1сЕ() 

>>> а = а1с+ (паме='Иван', зигпаще='Иванов'); а 

{ 'паме': 'Иван', 'загпаме': 'Иванов' } 

>>> а = 91с% ({"паме": "Иван", "загпаме": "Иванов"}); а 

{ 'паме': 'Иван', 'зиагпаме': 'Иванов' } 

>>> а = а1с+([["паме", "Иван"], ["зигпаме", "Иванов"]]); а 
{'паме': 'Иван', 'загпаме': 'Иванов' } 

>>> а = а1се([("паме", "Иван"), ("зогпаме", "Иванов")]); а 
{'паме': 'Иван', 'загпаме': 'Иванов'} 

>>> 


Первый оператор создает пустой словарь. Второй — создает словарь по па- 
рам Ключ=Значение. Третий оператор - создает словарь по словарю, да и 
в качестве параметров функции 41с"() мы передали уже готовый словарь. 


Четвертый оператор создает словарь по списку списков, а пятый - по спи- 
ску кортежей. Как видите, существуют различные способы создания`слова- 
рей, и вы можете выбрать тот, который вам больше нравится. 


В создании словаря может участвовать и функция 21р(). Она может объ- 
единить два списка в список кортежей, а затем созданный нею список мы 
можем передать в функцию @1с"(). Например: 


>>> Кеуз = ("паще", "загпаме") 

>>> уа1аез = ("Иван", "Иванов") 

>>> 1156(21р(Кеуз, уа1аез)) 

[('паме', 'Иван'!), ('загпаме', 'Иванов') ] 
>>> КУ = 1156(21р(Кеуз, уа1аез)) 

>>> а = асе (ку); а 

{ 'паме': 'Иван', "'загпаме': 'Иванов' } 
>>> 


У насесть два списка — Кеуз (ключи) и уашез (значения). Мы комбинируем 
их функцией 21р и создаем общий список Ку, который мы потом передаем в 
функцию с и получаем такой же словарь, как и раньше. 


Также создать словарь можно, заполнив его поэлементно, например: 


>>> а= {} 


>>> Аа["паме"] = "Иван" 

>>> Аа["загпаме"] = "Иванов" 

>>>а 

{'паме': 'Иван', "'загпаме': 'Иванов' } 
>>> 
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Если вам удобно, вы можете указать все элементы словаря в фигурных 
скобках: 


>>> а= {} 

>>> а = {"папе": "Иван", "зигпапе": "Иванов"}; а 
{'паме': "'Иван', 'зиаграпе': 'Иванов' } 

>>> 


При создании словаря нужно помнить, что в переменную сохраняется не 


сам словарь, а только ссылка на него, что нужно учитывать при группо- 
вом присваивании. Если вам нужно скопировать словарь, то вам нужно ис- 
пользовать не оператор присваивания, а метод сору(). Рассмотрим пример: 


‘>>> а = {"папе": "Иван", "загпапе": "Иванов"}; а 
{'паме': 'Иван', 'загпапе': "'Иванов'} 

>>> а2 =а 

>>> а2 1за 

Тгое 


>>> 42 = 4.сору () 
>>> 42 1за 
Еа1зе 

>>> 


Если присвоить 4 переменной 42, то оператор 1$ сообщит, что обе перемен- 
ные ссылаются на один и тот же объект в памяти (Тие). Если же скопи- 
ровать словарь через метод сору(), то будет создана независимая копия в 
памяти (оператор 1$ вернет Рабе). Однако метод сору() делает только по- 
верхностную копию словаря, для создания полной копии лучше использо- 
вать функцию @еерсору(): 


>>> порог сору 
>>> 42 = сору.Чеерсору (а); а2 


' Та ' ' ' Ё'. ' . 
3 , : 
{ 'папе Иван зигпаме Иванов' } 
>>> 42 1за 
Еа]1зе 
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10.2. Различные операции над 
словарями 


10.2.1. ДОСТУП К ЭЛЕМЕНТУ 


Начнем с доступа к элементу. Доступ осуществляется по ключу: 


>>> а["папе"] 

'Иван' 

При обращении к несуществующему элементу будет сгенерировано исклю- 
чение: 


>>> а["1азепаме" ] 
ТгасеБасКк (позе гесепЕ са]11 1аз®):” 
Е11е "<рузве11#25>", 11пе 1, 1п <тоди1е> 
а["1азЕпаме" ] 
КеуЕггог: "']азбпапе' 


Проверить наличие ключа можно с помощью оператора Ш: 


>>> "зигпапе" 1п а 
Тгиые 

>>> "1азепатме" 11 а 
Ра1зе 

>>> 


Узнать, сколько ключей есть в словаре можно с помощью функции [еп( "): 
>>> 1еп (42) 


2 
>>> 


10.2.2. ДОБАВЛЕНИЕ И УДАЛЕНИЕ ЭЛЕМЕНТОВ 
СЛОВАРЯ 


Добавить элемент в словарь можно так: 


>>> а 

{'паме': 'Иван', 'зигпаме': 'Иванов' } 

>>> а["1азепаме"] = "Иванов" 

>>>а 

{ '1азфпаме': 'Иванов', 'папе': 'Иван', 'загпапе': 'Иванов'} 
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Если ключ есть в словаре, то ему будем присвоено новое значение. Если 
ключа нет, то он будет добавлен в словарь. 


Удалить ключ из словаря можно с помощью оператора 41: 


>>> а 

{ ']1азбпаме': 'Иванов', 'паме': 'Иван', 'загпаме': 'Иванов' } 
>>> ае!1 а["1азпаме"]; а 

{‘паме': 'Иван', 'загпаме': 'Иванов' } 


10.2.3. ПЕРЕБОР ЭЛЕМЕНТОВ СЛОВАРЯ 


Перебрать все элементы словаря можно так: 
>>> Еог Кеу 11 Яа.Кеуз(): 
рг1пё ("({0} => {1})".Еогта® (Кеу, а[Кеу]), епа=" ") 


(папе => Иван) (загпаше => Иванов) 


10.2.4. СОРТИРОВКА СЛОВАРЯ 


Словарь - это неупорядоченная структура данных. Поэтому при выводе 


словаря его ключи выводятся в произвольном порядке. Вы же можете от- 
сортировать словарь по ключам. Для этого нужно получить сначала список 
всех ключей, а затем использовать метод 507 (): 


>>> Кеуз = 1156 (а.Кеуз ()) 
>>> Кеуз.зокге () 
>>> Еог Кеу 1щ Кеусв: 
рг1пЕ (" ({0}=> {1})".Еогма® (Кеу, Ч[кеу]), епа=" ") 
(паме=> Иван) (5агпаме=> Иванов) 


Данный пример не очень удачен, поскольку и до сортировки ключи в сло- 


варе находились в отсортированном порядке (так получилось), но если до- 
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бавитьв словарь новый элемент и повторить пример, все будет работать как 
нужно: 


>>> а["1азфпаще" ] ="Иванов" 
>>> а["71р"]="109011" 


>>>а 
{'21р': '109011', '1азфпаще': 'Иванов', 'паще': 'Иван', 
'зигпаме!: 'Иванов' } 


>>> Кеуз = 11536 (4.Кеуз()) 
>>> Кеуз.зогЕ () 
>>> Еог Кеу 1п Кеуз: 
рг1пё ("({0}=> {1})".Еоктаф (кеу, а[кеу]), епа=" ") 


(1азЕпапе=> Иванов) (папе=> Иван) (зигпапе=> Иванов) (21р=> 109011) 


10.2.5. МЕТОДЫ КЕУ$(), МАНИЕ$ () И НЕКОТОРЫЕ 
ДРУГИЕ 


Метод Аеу5(), как вы уже заметили, возвращает объект сЁ_Реуз, содержа- 
щий все ключи словаря. Данный объект поддерживает итерации, а также 
операции над множествами. 


Аналогично, метод оамез() возвращает объект сё оашез, содержащий все 
значения словаря. Данный объект также поддерживает итерации. Пример: 


>>> уа1аез = а.ха1аез () 
>>> 1134 (уа1аез) 
['109011', 'Иванов', 'Иван', 'Иванов"] 


Также у словарей есть много дополнительных и бессмысленных методов. 
Например, метод де) возвращает значение элемента, но его и так можно 
получить: 


>>> а.деЕ ("1азЕпаме") 
'Иванов' 

>>> а["1азепаще" ] 
'Иванов' 
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Особого смысла в этом методе нет, как и в методе с[еат(), который очищает 
словарь. А вот метод рор() может пригодиться. Он удаляет элемент и 
возвращает его значение: 


>>> а.рор ("1азЕпапте") 

'Иванов' 

>>>а 

{'21р': '109011', "'паще': 'Иван', 'загпаще': 'Иванов'} 


10.2.6. ПРОГРАММА О!СТ 


Продемонстрируем полученные знания на примере простой программы- 
словаря. В этой программе мы будем активно использовать оператор 1, 
чтобы выяснить, есть ли слово в словаре или нет: 


Е "Бы" др асе: 
рге1 пе (41с® ["Баз"]) 
е1зе: 
рг1п* ("Слова нет в словаре!")} 


Поскольку при обращении к несуществующему элементу словаря генери- 


руется ошибка, то перед обращением неплохо бы проверить его наличие с 
помощью оператора т. Напишем простейшую программу поиска по слова- 
рю. 


Листинг 10.1. Словарь %0.1 


АлсЕ = { 
"арр1е" : "яблоко", 
"ро1а" : "жирный", 
"Риз" ; "автобус", 
"саЕ" : "кошка", 
"саг" : "машина" } 
рг1п® ("=" х 15, "Ре, ПРА х 15) 
мог = "" 
м61]1е мога != "а": 
мога = 1при® ("Введите слово или а для выхода: ") 
1Е мога != "а": 
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1Е мога 1п 91с%: 

рг1п® (91с® [мога] ) 
е1зе: 

рг1п® ("Не найдено") 


Программа осуществляет поиск по словарю. Посмотрим, как она органи- 


зована. Сначала мы определяем переменную \ог4. Цикл \е будет рабо- 


тать, пока эта переменная не равна 4. 


В цикле пользователю предлагается ввести слово. Если слово не равно "4", 
то мы начинаем поиск по словарю. Если слово найдено, мы выводим его 
значение, если нет - то строку "Не найдено". 


Если пользователь введет "4", то в цикле мы ничего не делаем, а при следу- 
ющей итерации цикл будет прекращен. 


Продолжим разработку нашего Словаря. Попробуем модифицировать ис- 
ходную программу так, чтобы она поддерживала добавление и удаление 
элементов словаря, а также некоторые другие возможности. 

Листинг 10.2. Словарь у 0.1 


# Словарь заполнен по умолчанию 


асе = {4 
"арр1е" : "яблоко", 
"ро]А" : "жирный", 
*Роз" : "автобус", 
"са" : "кошка", 
"саг" : "машина" } 
РЕТНЕ("=" * 15; "Расе У О", "=" 15) 


# Справка. Будет выведена по команде В 
Ве1р_пеззаде = """ 

$ - Поиск 

а - Добавить новое слово 

г - Удалить слово 

К - Показать все слова 

Я - Показать весь словарь 

р - Справка 

а - Выход 


сВо1се = "" 
у11е сВо1се != "а": 
сво1се = 1пруё(" (в - Бе1р)>> ") 
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1Е сро1се == "з" 
мог = 1при* ("Введите слово: ") 
гез = 41се.деф (мога, "Не найдено!") 
рг1п (гез) 

е11ЁЕ сво1се == "а" 
мог = 1при ("Введите слово: ") 
уа1ие = 1пру* ("Введите перевод: ") 
1се [мога] = уа1ае 
рг1п ("Слово добавлено!") 

е11ЁЕ сВо1се == "г" 
мог = 1при* ("Введите слово: ") 
е1 а1с* [мога] 
рг1п{ ("Слово удалено") 


е11Ё спо1се == "К": 

рхг1п& (41с6.кКеуз ()) 
е11Ё спо1се == "а": 

Бог мог 1п а1с%: 

рхг1п® (мога, ": ", а1с& [мога]) 

е11Ё спо1се == "р": 

рг1п{ (Ве1р_пеззаде) 
е11ЁЕ сво1се == "а" 

соп&1п1е; 
е1зе: 


рг1п® ("Нераспознанная команда. Введите В для справки") 
Основной цикл программы: 


сНо1се = "" 
ир11е сро1се != "а" 
сро1се = 1 при (" (п г Ве1р) >> ") 


При каждой итерации мы выводим подсказку (№ — справка)>> и читаем 


ввод пользователя. Справка, а именно доступные команды отображаются 
по команде В. 


Поиск слова в словаре мы производим с помощью метода &еЕ(): 
1Е сро1се == "з" 
мога = 1при* ("Введите слово: ") 


гез = 41се.деф (мога, "Не найдено!") 
рг1пф (гез) 


Добавление осуществляется так: 


е11ЁЕ сво1се == "а" 
мога = 1при* ("Введите слово: ") 
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уа1ае = 1про* ("Введите перевод: ") 
Але [мога]..= уа1ще. 
ризпЕ("Слово добавлено!") 


Вывод словаря осуществляется в удобном для человека формате: 


е11Е сво1се == "а": 
Еог мога 1п @91с®: 
рге1пе (иога, ": ", 91с& [мота].) 


А вот вывод всех слов подойдет разве что для отладки. При желании вы 
можете модифицировать код, чтобы он выводил список слов в удобном для 
человека формате: 


е11ЁЕ сво1се == "К"; 
рг1 пе (91се.Кеуз()) 


Вывод будет таким: 


(п - 1е1р) >> к 
{се кеуз (['0495', 'арр1е', 'сае', '501а', 'рНопе', 'саг']) 


При:-вводе неизвестной команды программа выводит'соответбтвующее со- 
общение, а при вводе 4 происходит выход из программы: 


е11Е сВо1се == "а"; 
сопЕ1пае; 
е1зе: 


рг1 п ("Нераспознанная команда. Введите Н для справки ") __ 


| 8 СУМО! 5 \умета2А\сепа.еке - руУбов а сёру - х 


Рис. 10.1. Программа в действии 
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При вводе "4" мы вызываем ‚геак, чем инициируем переход на следующую 
итерацию. Далее в цикле \е будет проверено значение и произведен вы- 
ход из цикла. В принципе, можно было бы использовать БгеакК, чтобы сразу 
прервать работу цикла. 


10.3. Понятие множества 


Множество — это неупорядоченный набор уникальных элементов. Вы мо- 
жете проверить, входит ли тот или иной элемент в множество. Множество 
не может содержать два одинаковых элемента, все элементы множества 
уникальны. 


Создать множество можно с помощью функции 5е(): 


>>> $ = зе \() 
>>> $ 
зеё () 


Мы только что создали пустое множество. Однако функция 5е() может 
преобразовать во множество другие типы данных - строки, кортежи, 
списки. При преобразовании других типов данных помните, что во множе- 
стве останутся только уникальные элементы: 


>>> з = зеё ("Не11о"); 3 $ Строка 
Г, "©"; 'е', "5 } 

>>> зе: 2, 3 4, 5 4]) $ Список 
{1, 2, З; 4, 5} 

>>> за (1, №; З», За, 5)) $ Кортеж 


{1, 2, 3, 4, 5} 

10.4. Операции над множеством 
Вот как можно перебрать элементы множества: 

>>> Еог 1 1 $: рг1пе(1, епа=" ") 

1 оен 


Узнать количество элементов во множестве можно с помощью функции 


[еп(): 


>>> 1еп(3) 
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Но самое главное - не это. Прелесть множества в специальных операторах, 
предназначенных специально для множеств. Оператор | означает объедине- 
ние множеств: 


>>> $1 = зе ё([1, 2, 3]) 
>>> $2 зеё ([3, 4, 5]) 
>>> 53 = $1 | $32; $3 
{1, 2, 3, 4, 5} 

>>> 


Обратите внимание, что при объединении множеств, в созданное множе- 


ство попадают лишь уникальные элементы, что и продемонстрировано в 
этом примере. 


С помощью | МОЖНО добавить в одно множество элементы другого множе- 
ства: 


>>> $1 |= $52; $1 
{1, 2, 3, 4, 5} 


Оператор - означает разницу множеств: 


>>> $51 

{1, 2, 3, 4, 5} 
>>> 32 

{3, 4, 5} 

>>> $1 - 32 

{1, 2} 


Оператор $1 -= $2 удалит из множества $1 элементы, которые существуют и 
во множестве $1, и во множестве $2. 


Оператор & - это пересечение множеств. Результат пересечения - это эле- 
менты, которые есть в обоих множествах: 


>>> $1 зеё ([1, 2, 3]) 
>>> 32 зек ([3, 4, 5]) 
>>> 51 & 52 


{3} 


Оператор е возвращает элементы обоих множеств, исключая одинаковые 
элементы: 
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Оператор ш обеспечивает проверку наличия элемента во множестве: 


>>> 51 

{7, 2; 3} 
>>> 3 п $1 
Тгоае 

>>> 4 11 $1 
Ра1зе 


Оператор == обеспечивает проверку на равенство множеств: 


>>> $1 == $2 
Еа1зе 
>>> 


Оператор $1 <= $2 проверяет, входят ли все элементы множества $1 во мно- 
жество $2: 


>>> 51 

{1, 2, 3} 
>>> $52 

{3, 4, 5} 
>>> $1 <= $2 
Еа1зе 


Оператор $1 < $2 проверяет, входят ли все элементы $1 во множество $2, но 
при этом сами множества не должны быть равны. Аналогично, есть опера- 
торы >= и >. 


10.5. Методы множеств 


Множества поддерживают следующие методы: 

» аа4(<Элемент>) — добавляет <Элемент> во множество 

» гетоуе(<Элемент>) — удаляет <Элемент> из множества 

® 415саг4(<Элемент>) — удаляет указанный элемент из множества 
® рор(-— удаляет произвольный элемент и возвращает его 


® с]еаг()— очищает множество 


Методы 7етове() и @сата() отличаются тем, что если указанный элемент 
отсутствует во множестве, то в первом случае будет возвращена ошибка, а 
во втором никаких сообщений не будет: 
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>>> $1 

[17 и.) 

>>> $1.ааа (4) 

>>> $1.гетоте (4); $1 

Не 8 

>>> 51.гемоуе (4) 

Тгасебаск (мозЕ гесепЕ са11 1аз®) : 
Е11е "<рузре11#100>", 11пе 1, 1п <моао1е> 

$1.гепоте (4) 
КеуЕггог:; 4 
>>> $1.а1зсака (4) 


ГЛАВА 11. 
ПОЛЬЗОВАТЕЛЬСКИЕ 
ФУНКЦИИ 
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11.1. Объявление функции 


Прежде всего, нужно разобраться, что такое функция. В любом языке 
программирования имеются подпрограммы, которые служат для экономии 
кода программы и удобства программиста. В Руфоп подпрограммы называ- 
ются функциями. Функции, как в любом другом языке программирования, 
могут возвращать значения. Заметьте: могут возвращать, а могут и нет - все 
зависит от того, какую функцию вы разрабатываете. Вы можете написать 
функцию, добавляющую переданные ей аргументы в текстовый файл или в 
базу данных, но не выводящую никакого текста и не возвращающую ника- 
ких значений. 


Функциям в Ру!оп можно передавать параметры (аргументы). Примеча- 
тельно, что Руоп (как и некоторые другие языки программирования) по- 
зволяет создавать функции с произвольным числом параметров и функции 
с параметрами по умолчанию, что облегчает использование функций 


Функция может возвращать любой тип данных с помощью оператора 
гебигп, но, как уже было отмечено, использование этого оператора необя- 
зательно. Напишем первую нашу функцию, чтобы продемонстрировать не- 
которые особенности функций в Руоп. 


Глава 11. Пользовательские хъункции 


Объявление функции начинается со служебного слова 4]. Функцию мож- 
но объявить в любом месте сценария (хотя рекомендуется объявлять функ- 
ции в начале сценария или вообще вывести функции в отдельный файл, ко- 
торый вы будете подключать с помощью инструкции йпрот)), но до первого 
ее вызова. Формат объявления функции следующий: 


аеЕ <Имя_функции> ( [Параметры] ) : 
<Тело функции> 
[тебагп <Значение>] 


Имя функции — это уникальный идентификатор, состоящий из латинских 
букв, цифр и знаков подчеркивания. Параметры функции указываются в 
круглых скобках. Функция может иметь переменное число параметров, об 
этом мы поговорим позже. 


Функция может возвращать значение. Если есть возвращаемое значение, то 
оно указывается в инструкции тет. 


Рассмотрим простую функцию: 


аеЕ шзим(х, у): 
тееигп х + у 


К = мэам (3,5) 
рг1пе (К) 


Мы только что создали функцию тзит() с двумя параметрами — хи у. Ре- 
зультат работы этой функции — сумма переданных ей параметров х и у. 
Далее мы вызвали функцию с параметрами (3, 5) и присвоили результат ее 
выполнения переменной К. Последний оператор выводит значение К (8 в 
нашем случае). 


При вызове функции без параметров (если они определены при объявле- 
нии функции) вы получите сообщение: 


ТгасерасКк (тозЕ гесеп® са11 1а5%): 
Е11е "<рузве11#109>", 11пе 1, 1п <поао1е> 
шим () 
ТуреЕггог: шзим() п1$$1п4а 2 геаи1геЯ роз1%1опа1 агдитепе$: 'х' 
апа 'у' 
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Вы можете создать ссылку на функцию, например: 


5 = зам 
К 3(3,; 5) 


Обратите внимание, что при создании ссылки не нужно указывать круглые 
скобки после имени функции, иначе интерпретатор "подумает", что вы хо- 
тите вызвать функцию без параметров. 


Можно также передать ссылку на функцию в качестве параметра другой 
функции. Функции, которые передаются по ссылке, называются функция- 
ми обратного вызова (са[асЁ). Пример: 


аеЁ мзим(х, у) 
геогр х +у 


аеЕ Езим (Е, х, у): 
геёигп Е(х, у) 


К = Езом (пом, 3, 5) 


11.2. Необязательные параметры 
функции 


Ранее было показано, что, если вызвать функцию без параметров или с 


меньшим количеством параметров, то будет выведено сообщение об ошиб- 
ке. В Ру\оп вы можете задать параметры по умолчанию (необязательные 
параметры). Например: 
АаеЁ шзим(х, у=1): 

геёагпт х +у 


К = зам (3) # результатом будет 4 


Как видите, если второй параметр не задан, то его значение будет равно 2. 
Обратите внимание, что все необязательные параметры должны следовать 
после обязательных. Смешивать их нельзя, иначе получите сообщение об 
ошибке. 


До этого мы использовали только позиционное присваивание параметров, 
например: 


Глава 11. ПользоватеЛЬСКИЕ ФУНКЦИН 


изим (4, 5) 


В этом случае параметру х будет передано значение 4, а параметру и - 5. Но 
в Руфоп мы можем использовать сопоставление по ключам, например: 


>>> шзим(у=3, х=2) 
5 


Если значения параметров, которые планируется передать в функцию, со- 


держатся в кортеже или списке, то перед объектом следует указать символ 
*. 


>>> 11 = (2, 3) 


>>> ивим (*11) 
5 


‘Количество элементов в словаре должно быть равно количеству параме- 


тров, которые может принимать функция. 


Если значения параметров содержатся в словаре, то перед именем словаря 
нужно указать две звездочки**: 


Если вы указываете переменную в качестве значения параметра функции и 
передаваемый объект относится к неизменяемым типам, то, если функция 
изменяет значение параметра, это никак не отобразится на исходной пере- 
менной: 


>>> аеЕ {езе (х): 
х = 1 
тефагпт х 


>>> у=2 
>>> тез (у) 
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>>> 


Однако функция может изменять значения объектов изменяемых ТИПОВ, К 
которым относятся списки и словари. 


11.3. Переменное число параметров 
Представим, что вам нужно написать функцию, принимающую любое чис- 
ло параметров. Для этого используйте аргумент *. Пример: 


ЧеЕ ауч(Нгз®, *гез®): 
гебагп (НгзЕ + зим (гез+е)) / (1 + 1еп(гез®)) 


Рассмотрим пример использования функции: 


рг1пё (а\ч (1, 2)) # 1.5 
рг1 пе (ауа (1, 2, 3, 4)) {2.5 


В данном случае гезё — это кортеж, содержащий все дополнительно пере- 
данные аргументы. Наш код считает его последовательностью и работает 
как с последовательностью. 


Чтобы принять любое число именных параметров (ЁеушотА а’ёитепЁ5), ис- 
пользуйте параметр, который начинается с **. Например: 


1прогЕ Рп1 


4еЁ маке е1етеп* (паме, уа1ае, **а®егз): 


Кеууа1$ = [' %3="%5"' % 16еш Еог 16ем 1п а®бг$.16етз () ] 
аеЕг_з6г = ''.)о1п (Кеууа1$) 
е1етепЕ = '<{папе } {а г$}>{уа1ае}</{паме}>'.Еогмае ( 


паме=папе, 

а г5=аг_5&г, 

уа1ае=р&п1.езсаре (уа1ае) ) 
гебагл е1етепе 


Примеры использования: 
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# Создаем '<1%ем з12е="1агае" аиапе1у="6">Виз</1+еп>' 
паке е1емеп* ('1%ет', 'Ву$', $12е='1агде', чиап&1еу=6б) 


# Создаем '<р>&1%Е;Саг&а®е;</р>' 
маке е1етеп* ('р', '<Саг>') 


Здесь а г$ — словарь, который хранит переданные именные аргументы 
(если они были переданы, конечно). 


Если вы хотите написать функцию, которая сможет принимать любое чис- 
ло позиционных и именных параметров, используйте * и ** вместе. На- 
пример: 


еЁЕ апуагаз (*агд$, **Кмагаз): 
рг1п® (ага$) # Кортеж 
рг1п® (Киагаз) $ Словарь 


С этой функцией все позиционные аргументы будут помещены в кортеж 
агр$, а все именные аргументы будут помещены в словарь К\уагр$. 


Параметр * может быть указан исключительно как последний позицион- 
ный параметр в определении функции. Параметр ** тоже может появиться 
как последний параметр. Тонкий аспект определения функции - это то, 
что параметры могут все еще появиться после параметра *: 


аеЕ а(х, *агдз, у): 

разз 

4еЕ Ь(х, *агдз, у, **Кмагаз): 
разз 


11.4. Анонимные функции 


Некоторые функции, например, функции сортировки, подразумевают пе- 


редачу в качестве параметров пользовательских функций, определяющих 
порядок сортировки или что-либо еще. В таких случаях удобнее использо- 
вать короткие встроенные функции, а не создавать полноценные функции 
оператором 4е. 


п. Полное руковолство 


Простые функции, которые делают ни что иное, как просто вычисляют вы- 
ражение, могут быть заменены выражением /[атфаа. Например: 


>>> ааа = ТапБаа х, у: х + у 
>>> ааа (2,2) 

4 

>>> ааа ('Ве11о', 'мог1а') 
'ре11омог1а' 

>>> 


Использование /[атБаа здесь аналогично следующим кодом: 


>>> аеЕЁ ааа(х, у): 
за ь гебагп х + у 


>>> ааа (2,2) 
4 
>>> 


Как правило, [ата используется в контексте некоторой другой операции, 
такой как сортировка или сокращение данных: 


>>> памез = ['Ддорп', 'Беп', "'МагК', 'Дапе' ] 

>>> зогфеа(памез, Кеу=1атЬюЧа паме: паме.зр11* () [-1].1омек()) 
['Реп', "'ДФапе', 'ФоБп', 'Магк'] 

>>> 


Хотя атьаа позволяет вам определять простую функцию, определять та- 
кую функцию не рекомендуется. В частности, может быть определено толь- 
ко единственное выражение, результатом которого является возвращаемое 
значение. Это означает, что никакие другие функции языка, включая мно- 
гократные операторы, условные выражения, итерация и обработка исклю- 
чений не могут быть включены в эту функцию. 


Вы можете написать много Руфоп-кода, вообще не используя [атбаа. Од- 
нако вы будете иногда встречаться с ней в программах, где кто-то пишет 
много крошечных функций, которые вычисляют различные выражения 
или в программах, которые требуют, чтобы пользователи предоставили 
саПБаск-функции. 
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Рассмотрим поведение следующего кода: 


>>> х = 10 

>>> а = 1апЬаа у: х+у 
>>> х = 20 

>>> Б = 1апБаа у: х + у 
>>> 


Теперь задайте себе вопрос. Каковы значения а(10) и Б(10)? Если вы дума- 
ете, что 20 и 30, то вы ошибаетесь. 


>>> а(10) 
30 

>>> Ь (10) 
30 

>>> 


Проблема здесь в том, что значение х в выражении [атраа является свобод- 
ной переменной, которая связывается во время выполнения, а не во время 
определения. Поэтому значение х в ат Баа-выражении - то же, что и значе- 
ние переменной х во время выполнения. Например: 


>>> х = 15 
>>> а(10) 
25 

>>> х=3 
>>> а(10) 
13 

>>> 


Если вы хотите написать анонимную функцию, которая получает значение 
на момент определения и хранить ее, добавьте значение как значение по 
умолчанию, например: 


>>> х = 10 

>>> а = 1апЬаа у, х=х: х + у 
>>> х = 20 

>>> р = 1апБаа у, х=х: х + у 
>>> а(10) 

20 


>>> (10) 
30 
>>> 


Теперь поговорим о переносе дополнительного состояния в функциях об- 
ратного вызова. Представим, что вы написали код, который основывается 
на использовании са[Баск-функций (например, обработчики событий), но 
вы хотите, чтобы са!аск-функция хранила дополнительную информацию 
о состоянии для использования внутри функции. 


Этот пример связан с использованием функций обратного вызова, которые 
используются во многих библиотеках и структурах - особенно связанных 
с асинхронной обработкой. Для иллюстрации и из соображений тестирова- 
ния определим следующую функцию, которая вызывает функцию обратно- 
го вызова: 


АеЕ арр1у азупс(ЁЕипс, агд5, *, са11Ьаск): 
# Вычисляем результат 
гези1Е = Еапс (*аг9$) 
# Вызываем са11Ъаск-функцию и передаем ей результат 
са11Ъаск (хези1*) 


На практике такой код мог бы выполнять сортировку с использованием по- 
токов, процессов и таймеров, но здесь мы не. об этом. Вместо этого мы 
просто фокусируемся на вызове саПаск-функции. Вот пример, показыва- 
ющий, как можно использовать предыдущий код: 


>>> аеЕЁ рг1пЕ_гези1е (гези1®): 

ра рг1 п ('ВКези1*:', гезо16) 

>>> аеЕ ааа(х, у): 

... гераги х + у 

>>> арр1у_ азупс (аа, (2, 3), са11Баск=ре1пЕ гези1е) 

СоЕ: 5 

>>> арр1Ту азупс (ааа, ('ре11о', 'мог1А'), са11Баск=ркеапе гези1е) 
Вези1е: ре11омог1а 

>>> 


Как видите, функция ритЕ тезий() принимает только один аргумент, кото- 
рый является результатом. Никакая другая информация не передается в 
нее. Такой недостаток информации иногда может представлять проблему, 
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например, когда вы хотите, чтобы функции обратного вызова взаимодей- 
ствовала с другими переменными или частями среды. 


Один из способов хранить дополнительную информацию в функции об- 
ратного вызова — использовать метод (и, соответственно, класс) вместо 
функции. Например, следующий класс хранит внутренний номер последо- 
вательности, который вызывается при каждом вызове метода йапет(): 


с1азз Вези1ЕНапа1ег: 
аеЕ ._1пьЕ _(3е1Е): 
зе1Ё.зеацепсе = 0 
аеЕ Папа1ет (зе1{Е, гези1%): 
зе1Ё.зеацепсе += 1 
рх1пе('[{}] Результат: {}'.Еогма® (зе1{.зеацепсе, гези1+)) 


Чтобы использовать этот класс, вам нужно создать экземпляр и использо- 
вать связанный метод Вапег в качестве функции обратного вызова: 


>>> г = Вези1ЕНапа1ех () 

>>> арр1у_азупс (ааа, (2, 3), са11БасК=г.Папа1ех) 

[1] Везо1е: 5 

>>> арр1у азупс (ааа, ('пе11о', "'мог1Аа'), са11ФаскК=к.Папа1ек) 
[2] Веза1&: Ве11омог1а 

>>> 


11.5. Функции-генераторы 


Функция-генератор — это функция, которая может возвращать одно зна- 
чение из нескольких значений на каждой итерации. Превратить функцию 
в генератор позволяет ключевое слово уе. Рассмотрим пример простой 
функции-генератора: 


АеЕ деп (х, у): 
ох 1 1п гапоае (1, х+1): 
у1е1а 1 +у 


Вот как можно использовать генератор: 


Ру!поп. Полное руководство О __ 6%: руепоп 


>>> з = дев(3,3) 
>>> рг1пе(5. пехе_ ()) 


4 
>>> рг1пе(5.  пехе ()) 
5) 
>>> рг1пе (5. пехе ()) 
6 


>>> рг1пе (5. пехе ()) 
ТгасебасКк (тмозф гесепЕ са11 1аз+): 
Е11е "<рузве11#135>", 11пе 1, 1п <пмоаа1е> 
рг1пЕ ($. пехЕ  ()) 
ЗЕорТЕека+1оп 
>>> 


Как видите, при каждом следующем запуске функция увеличивает резуль- 
тат предыдущей операции на 1. Максимальное число итераций устанавли- 
вается вторым параметром, а первый параметр - начальное число, которое 
будет постепенно увеличиваться на 1. Четвертый вызов функции завер- 
шился с ошибкой 5юр[етайоп, поскольку второй параметр задает макси- 
мальное число итераций, равное трем. 


11.6. Декораторы 


Основное назначение декораторов — выполнить какие-либо действия перед 
выполнением функции. Рассмотрим пример: 


аеЕ аесо (Е): 
рг1пе ("му _Еапс 1$ гипп1тпа") 
гебагп Е 

@аесо 

аеЕ му _Еапс(х): 
хегагых * 2 


ре1 пе (ту Еапс (5) ) 


11.7. Рекурсия 


Рекурсия - это явление, когда функция вызывает саму себя. В современном 
программировании рекомендуется не использовать рекурсию и пытаться 
любой рекурсивный алгоритм заменить нерекурсивным. Опасность рекур- 
сии в том, что вы можете забыть предусмотреть условие выхода из рекур- 
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сии, и тогда функция будет запускать себя снова и снова и ничего хорошего 
из этого не получится. 


Классическим примеров рекурсивной функции является функция вычис- 
ления факториала: 


АеЕ Гас® (п): 
1Е п == 0 ог п == 1; гебагп 1 
е1зе: 
геЕогп п * Еас® (п - 1) 


Как видите, мы предусмотрели условие выхода из рекурсии - если п = 0 
или п = 1, то функция просто возвращает 1. В противном случае функция 
вызывает саму себя, передав значение п, уменьшенное на 1. Следовательно, 
при каждом вызове функции значение параметра будет уменьшаться, а ког- 
да оно станет равно 1, функция просто вернет 1. 


Ради справедливости нужно отметить, что функция вычисления факториа- 
ла называется /асопа[() и имеется в модуле тай. 


11.8. Глобальные и локальные 
переменные 


Глобальные переменные — это все переменные, объявленные за пределами 
функции. Локальные переменные - это переменные, объявленные в самой 


функции. 


11.8.1. ИНКАПСУЛЯЦИЯ 


А зачем функции возвращаю значения? Посмотрим на такую функцию: 


АеЕ Гоп (): 
гез = 10 
гебагп гез 


Почему бы нам не обратиться к переменной ге$ напрямую - в коде нашей 
программы? Спешу вас огорчить: потому что нельзя. Переменная гез не 


Рупоп. Полное руководство а _ 9; руепоп 


существует вне функции. Вообще ни одна переменная, созданная внутри 
функции (в том числе и параметры), извнё не доступна. Данная техни- 
ка называется инкапсуляцией. Она помогает сохранить независимость от- 
дельных фрагментов кода. Параметры и возвращаемые значения использу- 
ются, чтобы передавать важную информацию и игнорировать все прочее. За 
значениями переменных, созданных внутри функции, не нужно следить во 
всем остальном коде, что очень удобно. И чем больше программа, тем более 
заметно это преимущество. 


Поскольку код функции скрыт от основной программы и от других функ- 
ций, в разных функциях вы можете использовать одни и те же имена пере- 
менных, например, гез для обозначения результата. 


11.8.2. ОБЛАСТЬ ВИДИМОСТИ. КЛЮЧЕВОЕ СЛОВО 
СЕОВАЕ 


Благодаря инкапсуляции, функции как бы закрыты от основной програм- 


мы и от других функций. Пока мы знаем только единственный механизм 
обмена информацией между ними -— это параметры и возвращаемые значе- 
ния. Однако есть еще и другой способ — глобальные переменные. 


Область видимости — это способ представления разных частей програм- 
мы, отделенных друг от друга. 


Рассмотрим небольшой пример: 


аеЁ Еоап1(): 
гез = 10 
рг1п* (гез) 


аеЁЕ Еоп2 () 
гез = 20 
рг1пЕ (ге5) 


гез = 30 
рг1п (ге$) 
Еап1 () 
Еап2 () 


рг1пЕ (ге5) 


Вывод программы будет таким: 
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30 
10 
20 
30 


Сначала мы определили две функции, внутри каждой из них переменной 
гез присваивается разное значение - 10 и 20 соответственно. Далее в основ- 
ной программе мы определили переменную гез со значением 30. 


Сначала мы выводим значение переменной ге$ до запуска функций. Затем 
запускаем обе функции и снова выводим значение переменной гез, чтобы 
убедиться, что ни одна из функций его не изменила. 


Как видите, программа и две наших функции выводят собственные значе- 
ния переменной гез, а все потому что у нас есть целых три области видимо- 
сти — одна глобальная (программа) и две локальные - по одной для каждой 
из функций. 


Любая переменная, созданная в глобальной области видимости, называет- 
ся глобальной. Переменная, объявленная в локальной области, называется 
локальной. 


Если вам нужно получить доступ к глобальной переменной, тогда нужно 
использовать ключевое слово юра. Изменим нашу программу так: 


аеЕ Еоп] (): 
91о0Ба1 гез 
рг1п (гез) 


аеЕ ЁГоп2 (): 
гез = 20 
рг1пе (гез) 


гез = 30 
рг1пё (гез) 
Еоп1 () 
Еоп2 () 


рг1пЕ (гез) 


Теперь вывод программы будет такой: 


30 
30 
20 
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30 

Посмотрим, что произошло. Сначала мы вывели значение гез, определен- 
ное в основной программе. Затем мы вызвали функцию /ит1(), которая бла- 
годаря ключевому слову =/оба! получила доступ к глобальной переменной 
гез и вывела ее значение. Функция /ип2() вывела собственное значение гез. 
Далее мы отобразили значение переменной ге$ из глобальной области. 


Использование ключевого слова =оба| позволяет не только читать, но и за- 
писывать, то есть изменять значение глобальной переменной. Рассмотрим 
следующий пример: 


аеЕ Ёип1 (): 
91ора1 гез 
гез = 50 


рг1п® (гез) 


АеЕ Еип2 (): 
91оБа1 гез 
рг1п® (гез) 

гез = 30 

рг1п® (гез) 

Еап1 () 

Еап2 () 


рг1п (ге$) 


Изначально значение глобальной переменной гез было 30. Затем в функ- 
ции /ип1() мы изменили его на 50. Функция /ип2(), поскольку она вызы- 
вается после функции /ип1(), получает уже новое значение - 50. Поскольку 
функция /ип1() изменила значение переменной гез() в глобальной области, 
то последний оператор рипё() отобразит также 50. В итоге вывод програм- 
мы будет таким: 

30 

50 


50 
50 


11.8.3. СТОИТ ЛИ ИСПОЛЬЗОВАТЬ ГЛОБАЛЬНЫЕ 
ПЕРЕМЕННЫЕ? 
Да, в РуФоп вы можете использовать глобальные переменные. А нужно ли? 


Ведь, по сути, тогда вы лишаетесь преимуществ инкапсуляции - вам нужно 
будет следить за значением переменной. Одна логическая ошибка в боль- 
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шой программе приведет к непоправимым последствиям и многочасовой 
отладке. Нужно ли вам это? Глобальные переменные только запутывают 
код, поскольку за их постоянно меняющимися значениями сложно следить. 
Поэтому постарайтесь ограничить их использование по максимуму. Основ- 
ной девиз должен быть таким: если можно обойтись без глобальной пере- 
менной, сделайте это. 


11.9. Документирование функций 


Очень полезно документировать функции по мере их написания. Пройдет 
время и вы даже не сможете вспомнить, как работает та или иная функция, 
какие параметры она должна принимать. Конечно, в простом случае до- 
статочно взглянуть на ее код и все станет понятно, но есть ситуации, когда 
функции содержат сотни строк кода. В таких ситуациях на помощь прихо- 
дит документирование. 


В РуШоп есть особый механизм, который называется документирующими 
строками. Такие строки представляют собой строку в тройных кавычках. В 
блоке кода документирующая строка должна обязательно идти первой по 
порядку. Рассмотрим пример: 


еЕ магп10д (меззачде) : 
""" Выводит сообщение, заданное параметром щеззачде, 
обрамленное символами * для привлечения внимания """ 
рг1пе ("*" * 10, пеззаде, "*" * 10) 


Данная строка воспринимается как многострочный комментарий и никак 
не обрабатывается интерпретатором, тем более не выводится на экран и не 
возвращается в качестве значения функции. 


При желании документировать функцию можно и с помощью комментари- 
ев. Но использование документирующих строк элегантнее и удобнее. 


11.10. Возвращаем несколько 
значений. 


Иногда нужно, чтобы функция вернула несколько значений. Для этого 
просто возвращайте кортеж, например: 


аеЕ Еип(): 
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гебагп 1, 2, 3 
а, Ю, с = Еап() 
рг1п® (а, Б, с) 


В результате будет выведено 


Хотя кажется, что функция /ит() возвращает несколько значений, на самом 
деле она возвращает одно значение, но в виде кортежа. Это выглядит немно- 
го странным, но кортеж формирует запятая, а не круглые скобки. Пример: 


>>> а = (1, 2) # Со скобками 
>>> а 

(1, 2 

>>> Б=1, 2 # Без скобок 
>>> Ь 

(2; 2 

>>> 


При вызове функций, которые возвращают кортеж, принято присваивать 
результат несколько переменным, как было показано выше. Это просто — 
распаковка кортежа. Возвращаемое значение можно также присвоить од- 
ной переменной. 


11.11. Именованные аргументы 


Давайте рассмотрим функцию йе[о, использующую самый простой способ 
передачи параметров: 


АаеЕ Бе11о (паме, с1%у): 
рг1п ("Привет, ", паме, "! Мы едем в", с1%у) 
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Ничего сложного. Мы просто определили два параметра - пате и сКу. Пер- 
вый - имя, второй город. Такие параметры называются позиционными, по- 
скольку строго определен порядок их следования. Значения функция при- 
нимает в том же порядке, что и указаные позиционные параметры. 


Рассмотрим вызов функции: 


ре11о("Марк", "Санкт-Петербург") 


Вывод будет таким: 


Привет, Марк! Мы едем в Санкт-Петербург 


А что будет, если программист перепутает порядок следования аргументов: 


Ве11о("Санкт-Петербург", "Марк") 


Тогда параметру пате будет передано значение "Санкт-Петербург", а пара- 
метру сКу - "Марк". В итоге вывод будет не таким, как мы ожидали: 


Привет, Санкт-Петербург! Мы едем в Марк 


Это у нас еще простой случай, а представьте, если бы второй параметр был 
числом и далее шла его обработка как числа. Тогда мы бы получили ошибку 
и выполнение программы было бы остановлено! 


Специально для таких случаев предназначены именованные аргументы. 
Они позволяют указывать аргументы в любом порядке при условии, что мы 
задаем имя аргумента. Вызовем функцию так: 


Ве11о(с1у = "Санкт-Петербург", паще = "МоМаще") 


Преимущества использования именованных аргументов следующие: 


® Ясность - вы знаете, какое значение и какому параметру передаете. Даже 
если вы будете указывать параметры в том же порядке, в котором они и 
объявлены, использование именованных аргументов добавляет прозрач- 
ности в вашу программу. 


® Возможность изменения порядка следования параметров - если вы на- 
мерено изменили порядок следования аргументов (потому что вам так 
захотелось) или случайно перепутали его, ничего страшного не произой- 
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дет, и функция будет работать корректно (в отличие от использования 
позиционных параметров). 


11.12. Практический пример: 
программа для чтения В$$-ленты 


Формат новостной ленты К$$ довольно популярен во всем мире, особенно 
на новостных сайтах и всевозможных форумах. Многие пользователи пред- 
почитают читать К55-ленту, а не заходить на сайт. Почему? Да потому что в 
К5$5-ленту не попадает реклама и прочий не нужный пользователю контент 
— он видит только текст новости и некоторые другие служебные данные 
(дату и время публикации, имя автора и т.д.) 


Сейчас мы попробуем написать программу, которая будет читать В$$ но- 
востную ленту (лист. 11.1). 


Листинг 11.1. Программа для чтения В$$ 


АеЕ гзз_геадег (иг1): 
Егом их1116.гедиезЕ 1трогЕ иг1ореп 
Егом хп1.есгее.Е1етепЕТгее 1птрогЕ рагзе 


# Загружаем В$5-ленту и парсим ее 
и = ог1Тореп (иг1) 
ос = рагзе (п) 
# Извлекаем и выводим итересующие теги 
Еог 1$ем 1п аос.16егйпа ('сваппе1/1еет'): 
{1Е1е = 1еем.Ноаеехе ('Е1Е1е') 
Чафе = 1Еем.Нрасехе ('роЮрафе') 
110К = 1&ем.Ноаеехе ('11пк') 


рг1пЕ (Е161е) 
рг1п (Чафе) 
реле (11пК) 
рг1пЕ () 


гзз геааег ('Бфр://ехапр1е.сом/гз$.рНр') 
Итак, у нас есть функция 755_теа4ег(), которой нужно передать адрес но- 


востной ленты. Посмотрим, что происходит внутри функции. Первым де- 
лом импортируются модули иПореп и рагзе. Первый нужен для открытия 
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удаленного документа, второй — для разбора (парсинга ХМТ--формата, в 
котором и распространяется новостная лента). 


Далее в переменной и мы читаем новостную ленту, адрес которой задается 
параметром ий. После мы выполняем парсинг этой ленты и результат 
сохраняем в 40с. 


Переменная 4ос содержит уже "разобранную" новостную ленту. Функция 
хт|.етее. Нетеп(Тгее.рагзе() парсит весь ХМГ--документ в объект докумен- 
та. Вы можете использовать методы вроде Дпа(), иейта() и Лиехё() для 
поиска определенных ХМГ-документов. Аргументы к этим функциям - 
имена определенных тегов, вроде сБаппе|/{ет или ИЦ е. 


При определении тегов вы должны принять полную структуру докумен- 
та во внимание. Каждая операция Йп4 работает относительно начального 
элемента. Аналогично, имя тега, которое вы передаете каждой операции, 
тоже указывается относительно начального элемента. В примере вызов к 
Чос.кегЯпа(‘сБаппе/цег’) находит все элементы "Цет", которые находят- 
ся внутри элемента "сБаппе|". "дос" представляет верхнюю часть документа 
(элемент "гзз"). Более поздние вызовы йет.диех(() будут иметь место от- 
носительно найденных элементов "Цет". 


Далее в цикле мы просто находим и выводим элементы ие, риБ)аце, ПпК. 
Как правило, элементы с такими названиями есть в большинстве случаев, 
но вы можете просмотреть код В$$-ленты и изменить названия элементов, 
если в коде используются другие. 


ГЛАВА 12. 


ДАТА И ВРЕМЯ 
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12.1. Получение текущей даты и 
времени 


В Руоп для работы с датой и временем используются модули Ите, 


Чабейте, са]еп4аг, итей. Первый модуль позволяет получить текущую 
дату и время, а также произвести форматированный вывод времени/даты. 
Второй модуль используется для манипулирования датой и временем. 
Третий модуль позволяет вывести календарь в виде простого текста или 
НТМЕ-кода. Последний модуль позволяет измерять время выполнения 
фрагментов кода — он используется для оптимизации программы. 


Начнем с модуля ите. Функция Ите позволяет получить число секунд, 
прошедшее с 1 января 1970 года (эта дата считается началом эпохи ИМХ- 
систем, поэтому во многих языках программирования считается началь- 
ной): 


>>> ппрогЕ Е1те 
>>> Еаме.Е1те () 
1528374820.9274228 
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Понятно, что такая дата будет удобна’лишь самому компьютеру, но не чело- 
веку. Пока вы высчитаете, какому времени соответствует выданный функ- 
цией результат, время существенно изменится. Поэтому для работы с датой 
и временем лучше использовать другую функцию, например, ётйте(), ко- 
торая возвращает объект 5{тисЕ_Ите, представляющий универсальное время 
ОТС. Функции передается единственный параметр — количество секунд, 
прошедшее с 1 января 1970 года, то есть то, что возвращает функция йте(): 


>>> Е = Еще. Е 1те () 

>>> Е1ше .ашЕ1ште (+) 

Е1ме.зЕгасе Е1те (Е п_уеаг=2018, Ем поп=б, &м паау=7, &м_ 
Воцг=12, Ем п1п=33, 6ш_зес=54, Ем иЧау=3, Ем удау=158, Ем_ 
154$6=0) 


Как видите, это структура. Использовать структуру нужно так: 


>>> (и = ве .ате1ще (6) 
>>> сп. ва _роцг 
12 


Если нужно не ОТС-время, а местное время, тогда нужно использовать 
функцию юсате(), которая также принимает также количество секунд, 
прошедшее с 1 января 1970 года. Если нужно работать с текущим временем, 
то ни в [оса/ите(), ни в втИте() не нужно вообще ничего передавать — по 
умолчанию будет использовано локальное время. Функция оса те(), как 
и тите(), возвращает объект 5исЁ_Ите, содержащий следующие атрибу- 
ты: 

® (шп уеаг - 0 - год; 

® {п топ - 1 — месяц (число от 1 до 12); 

® (п пдду - 2 - день месяца (число от 1 до 31); 

® (п Во - 3 - час (число от 0 до 23); 

® {Ш шп - 4 - минуты (число от 0 до 59); 

® (1 $6ес-5 - секунды (число от 0 до 59); 


® (п \маду - б — день недели (число от 0 (для понедельника) до 6 (для вос- 
кресенья)); 


рун 


®_ {т Удлу - 7 - количество дней, прошедшее с начала года (число от 1 до 
366); 


® {т 154$ - 8 — флаг коррекции летнего времени (значения 0, 1 или -1). 


12.2. Форматирование даты и 
времени 


Понятно, что можно проанализировать объект 5стисё Ите и отобразить 
информацию о времени/дате так, как вам нужно. Но гораздо проще не за- 
ниматься этим вручную, а поручить форматирование даты и времени спе- 
циальным функциям. Например, функция 5#/#те() возвращает строковое 
представление даты в соответствии с заданной строкой формата: 


зЕгЕЕ1те (<строка формата>[, «объект зсгас®_&1те>]) 


Первый параметр - это строка формата, мы ее рассмотрим чуть позже. Вто- 
рой параметр - необязательный. Если он не указан, то будет использована 
текущая дата (время). Как именно будет отображаться дата и время, зави- 
сит от локали. Рассмотрим несколько примеров: 


>>> Ее. зЕгЕЕ1ше ("%$а.%т.$%У") 
'22.03.2021' 

>>> Ее. зЕгЕЕ1ше ("%Н:%М:%5") 
'15:34:56' 


Для обратного преобразования, то есть строки, содержащей дату в объект 
эгисё_Ите, используется функция $йрНте(): 


зЕгрЕ1ме («строка с датой>[, <строка формата>]) 


Формат можно не указывать (второй параметр). Первый параметр — это 
строка с датой /временем, которая будет преобразована в объект 5 'исЁ_Ите, 
который и будет возвращен функцией. Если строка не соответствует фор- 
мату, вы получите исключение УмшеЕтот. 


В строке формата могут использоваться следующие модификаторы: 
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® Фа аббревиатура дня недели в зависимости от настроек локали; 
® %А — название дня недели в зависимости от настроек локали; 
® %т — номер месяца с предваряющим нулем (от "01" до "12"); 


» %Б- аббревиатура месяца в зависимости от настроек локали (например, 
"1еЪ” для января); 


» %В - название месяца в зависимости от настроек локали (например, 
"МагсВ"); 


» %4- номер дня в месяце с предваряющим нулем (от "01" до "31 "); 
® %)]- день с начала года (от "001" до "366"); 


» %0- номер недели в году (от "00" до "53"). Неделя начинается с воскре- 
сенья. Все дни с начала года до первого воскресенья относятся к неделе 
с номером 0; 


® %У - номер недели в году (от "00" до "53"). Неделя начинается с по- 
недельника. Все дни с начала года до первого понедельника относятся к 
неделе с номером 0; 


® %\ — номер дня недели ("0"- для воскресенья, "б"-для субботы); 
® %Н - часы в 24-часовом формате (от "00" до "23"); 

» %1Т- часы в 12-часовом формате (от "01" до "12"); 

® %М -— минуты (от "00" до "59"); 

® %5 — секунды (от "00" до "59"); 

® %р- эквивалент значениям АМ и РМ втекущей локали; 
® %с_ представление даты и времени в текущей локали; 

® %х — представление даты в текущей локали; 

® %Х - представление времени в текущей локали; 

® %у- год из двух цифр (от "00" до "99"); 

® %У - год из четырех цифр (например, "2021"); 

® %7- название часового пояса или пустая строка; 


е %% — символ "%". 


Прежде, чем форматировать дату и время, нужно импортировать локаль: 
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>>> пироге 1оса1е 
>>> 1оса1е.зек1оса1е (1оса1е.1С_ АЬГ, ('ги551ап')) 
'Ви551ап_Виз51а.1251' 


После этого можно работать с датой и временем: 


>>> рк1пе(Е1ще.зегЕЕ1те ("%А %а %Ь %уУ %Н:%М:%5\п%а.%т.%у")) 
пятница 19 мар 2021 18:42:47 
19.03.2021 


12.3. Модуль саепдаг 


Модуль сайепдаг можно использовать для вывода календаря в текстовом 
формате или в НТМГ. В этом модуле вы найдете следующие классы: 

® Саеп4аг — базовый класс, который наследуют все остальные классы 

»® Тех(Саепдаг — текстовый календарь 

» НТМГСаепдаг - календарь в формате НТМГ. 


» ГосаеТех{Саепдаг — позволяет вывести календарь на языке указанной 
локали 


е® ГосаенНтТМГСаепдаг — то же самое, что и Госа]е НТМГ.Саепдаг, но вы- 
водит календарь в формате НТМГ. 


Каждому из этих классов нужно передать первый день недели. "Локализи- 
рованным" классам нужно также еще передать название локали. 


>>> пирог са1еп4аг 
>>> с = са1епдаг.Ъоса1еТехеСа1епЧак (0, "Виз3з1ап_Кизз1а.1251") 
>>> рг1пЕ (с. Еогмафуеахг (2021)) 


Данный код выводит календарь на 2021 год на русском языке в текстовом 
формате. Результат работы программы приведен на рис. 12.1. 


Аналогично, вы можете использовать класс Г.оса1еНТМГСаепдаг, чтобы 
создать календарь в формате НТМГ. 


Орноп$ Мипаом 


Июнь 

Пн Вт Ср Чт Пт С6 Вс о ВС: Ср чт пт 

В 2 $3 234 

53 @ 9. 28 90: 9 10 11 

13 14 15 16 17 18 16 17 18 

20 21 22 23 24 25 23 24 25 
27 28 29 30 30 


Июль Сентябрь 
Ср Чт Пт Ср Чт Пт 
га 123 

7: Вт: 9 11, 8. 910 
14 15 16 11 12 № 15 16 17 
21 22 23 18 19 20 22 23 24 
28 29 30 25 26 27 . 29 30: ^ 


Октябрь Ноябрь Декабрь 
Ср Чт Пт Ср Чт Пт Ср чт п" 
1 345 Е 2-3 
518 10 11 12 8 $1 
13 14 15 17 18 19 15 №68 37 
20 21 22 24 25 26 22 23 24 
27 ЭВ 29 29 30 3 


Рис. 12.1. Календарь в текстовом виде 


12.4. Функция Зеер 


В модуле ите есть очень полезная функция - ${еер(), позволяющая прио- 
становить выполнение сценария на указанное в секундах время. Например: 


проге Е1ще аз Е 
Е.эз1еер (10) 


В данном случае выполнение сценария будет приостановлено на 10 секунд. 


12.5. Измерение времени 
выполнения фрагментов кода 


Модуль итек содержит очень полезные функции, которые можно исполь- 
зовать для оптимизации работы программы, а именно для определения, 
сколько времени выполняется тот или иной фрагмент кода. 
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Используя модуль Итей, вы можете определить "узкие" места в произво- 
дительности вашей программы. 


Измерение производительности производятся с помощью класса Типег. 
Конструктор класса 'Типег выглядит так: 


Тлаег ( [з&{='код'][, зебир='код_настройки'][, Е1техг=<функция_ 
таймера>]) 


Первый параметр - это код, время работы которого нужно измерить. Вто- 
рой параметр -— это код, который должен быть выполнен до измеряемого 
кода. Здесь, например, можно загрузить необходимые для выполнения ука- 
занного в первом параметре кода модули. Третий параметр задает функцию 
таймера. 


Метод итей объекта Типег позволяет измерить время выполнение кода. 
Параметр питфег задает количество выполнений кода, например: 


{1те1* (попрег=1000) 


По умолчанию код зебир выполняется один раз, а код $етё — один миллион 
раз, если иного не задано параметром питфег. 


Метод тереа{) позволяет вызвать метод Ййтей() несколько раз. Его параме- 
тры по умолчанию выглядят так: 


гереа*% (гереа*=3, попрег=1000000) 


Первый параметр задает, сколько раз будет вызван йтей(), второй — значе- 
ние питфег, которое будет передано в Итей. Метод возвращает результат 
для каждого выполнения йтей(). 


Типичное использование всего этого выг лядит так: 


$ = Тек (...) # за пределами +гу/ехсере 
Вазу 

Е. Е1ме1* (...) $ или Е.гереа®(...) 
ехсер*: 


{.рг1пе ехс() 
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Пример: 


>>> пирог Е1те1е 

>>> Е = Елиеле.Тлмекг ('сраг 1п %ех®', зефор='6ехЕ = "затшр1е 
зЕг1па"; сраг = "а"') 

>>> Е. ЕлметеЕ () 

0.14950477718537059 

>>> Е.гереае+ () 

[0.11337469360387331, 0.11169325663377094, 
0.11340548288711716] 

>>> 


Зачем все усложнять? Ведь теоретически, можно написать такой код: 


Егом &1ще 1трогё * 


{1 = Е1ме() 
# Код, время выполнения которого нужно измерить 
{2 = &1те() 


ВЕЬНЕР = УВ 


В результате в & будет содержаться время выполнения кода в секундах. Но 
такой способ не даст таких точных измерений, как метод Иитей, хотя бы по- 
тому что он считает, сколько времени прошло в общем, а ни сколько заняло 
выполнение кода. Рассмотрим пример: 


>>> Егом 6лще 1прогЕе * 
>>> {1 = +1ще() 

>>> рг1пЕ ( 'Привет') 
Привет 

>>> Е2 = Е1ше () 

В в ^- 
27.69154500961 3037 

>>> 


Неужели на вывод строки Привет было потрачено 27 секунд? Конечно же 
нет. В среде ГОГЕ этот метод вообще использовать нельзя, поскольку он 
учитывает не только время выполнения кода, но и время набора этого кода 
программистом. В реальных программах данный метод сгодится разве что 
для грубого оценивания больших фрагментов кода, где сотые секунды - не 
важны. 


Для выполнения преобразований и вычислений, вовлекающих единицы 
времени, в РуВоп используется модуль даёейте. Например, чтобы пред- 


ставить интервал времени, создайте экземпляр #тедейа: 


>>> Егом аавее1те 1птрог®е &1теае1*а 
>>> а = е1меде1$а (4ауз=3, Вопгз$=4) 


>>> Ь = слмеае1{ а (Воцгз=6.5) 
>>> с=а+Ь 

>>> с.аауз 

3 

>>> с.зесопаз 

37800 

>>> с.зесопаз / 3600 

10.5 


Обратите внимание: свойства у йоитз нет, вместо него нужно разделить 
свойство 5есопеб на 3600. 


Если вам нужно представить специфические даты и время, создайте экзем- 
пляр дайейте и используйте стандартные математические операции для 
манипуляции с ним. Например: 


>>> Егом Аабее1те 1проге Чафее1те 
>>> Его Чафее1те 1прог® &1теае1*а 
>>> а = аакее1те (2021, 3, 20) 

>>> рг1пе (а + &1теае1*а (Ч4ауз=5)) 
2021-03-25 00:00:00 

>>> Ь = дафее1те (2021, 7, 27) 

>>> а=ь-а 

>>> а.Чауз 

129 

>>> пои = Чавее1те.*одау () 

>>> рг1пЕ (пом) 

2021-03-19 19:00:26.413132 

>>> рг1пе (пом + Е1теде1{а (Ч4ауз=2)) 
2021-03-21 19:00:26.413132 

>>> 
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>>> от ааъевще 1прог® Чаабебте 
>>> Ехо аабеслще хе слаеае]ка 
>>> а = Часее1те (2021, 3, 20) 

>>> ргзпе(а + в1щеде1ка (4ау$=5)} 
2021-03-25 00:00:00 

>>> Ь = дасее1ще (2021, 7, 27) 

>>> а=ь-а 

>>> 4.Чауз 

129 

>>> пом = аазее1те .содау (} 

>>> реп (пом) 

2021-03-19 19:00:26.413132 

р>> ргтпЕ(пом + еппеде1 ка (Чауз=2) } 
2021-03-21 19:00:26.413132 

>>> 


Рис. 12.2. Практическое использование модуля аеНнте 


ГЛАВА 13. 
МОДУЛИ И ПАКЕТЫ 
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13.1. Понятие модуля 


Модулем в Руоп называется любой файл с программой. Каждый модуль 
может импортировать в себя другой модуль, в результате чего он получает 
доступ к идентификаторам, находящимся в другом модуле. 


Получить имя модуля можно с помощью специального атрибута __пате__. 
Ранее у нашей программы был только один модуль (к которому мы, воз- 
можно, подключали другие модули) - __таш__. Проверить, что мы нахо- 
димся в __таш__ можно так: 


1Е _ папе == "_ па1п_": 
<сделать что _то> 


13.2. Инструкция иптрои 


Для подключения другого модуля используется инструкция йпроп, в кото- 
рой мы уже все знакомы: 


1прогЕ <название модуля> 
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Например: 


1проге 16егеоо15$ 


Затем обратиться к идентификатору, находящемуся в модуле можно так: 


16егеоо13.сочпЕ () 


Однако имена некоторых модулей слишком длинные, и чтобы сделать код 
компактнее, вы можете использовать псевдонимы модулей. Псевдоним за- 
дается с помощью конструкции: 


1проге <модуль> аз <псевдоним> 


Например: 


1проге 16егеоо1$ аз 1% 


После этого все идентификаторы модуля йейооб будут доступны через 
псевдоним 16: 


1е.сочпе () 


Вот еще пример: 


1прогЕ маёВ аз м 
‚а = щ.р1 * 10 


Мы подключили модуль таёВ, создали псевдоним т и доступ к числу Пи 
теперь осуществляется через идентификатор т.р. 


Теперь немного практики. Создайте два файла — таш.ру и тодше.ру. Во 
второй файл поместите указанный в листинге 13.1 код. 
Листинг 13.1. Файл тодше.ру 


# -*- соа1п9: чЕЕ-8 -*- 
а = 0 


В модуле тодше.ру мы определили только один идентификатор - а. Теперь 
создайте файл таш.ру (лист. 13.2). 
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Листинг 13.2. Файл тат.ру 


# -*- соа1па: пЕ-8 -*- 
1прокЕ по@11е аз м 


а = 2 
рк1п® (а) 
рк1п® (м.а) 
1прие () 


Сначала вы увидите число 2 - это значение идентификатора а в основной 
программе. А затем вы увидите число 0 -— это значение идентификатора с 
таким же именем в модуле. Думаю, принцип понятен. 


Примечание. Обратите внимание на содержимое папки с фай- 
лами после подключения модуля тодще.ру. Внутри папки ав- 
томатически был создан каталог _русаспе_ с файлом тодие. 
срупоп-32.рус. Этот файл содержит скомпилированный байт- 
код одноименного модуля. Байт-код создается при первом им- 
портировании модуля и изменяется только после изменения 
кода внутри модуля. 


13.3. Инструкция гот 


Инструкцию от удобно использовать для импорта только определенных 
идентификаторов. Синтаксис следующий: 


Егош <название модуля> ппрог® <идентификатор> [аз <псевдоним>] 


Пример: 


Егош шаеВ 1троге р1 


После этого к идентификатору р! можно ссылаться напрямую, без указания 
имени модуля и псевдонима: 
а = р: * 10 


Для импорта всех идентификаторов из модуля можно использовать звез- 
дочку *: 
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Его <название модуля> 1трогЁ * 


Посмотрим, что произойдет с нашей программой, если использовать 
инструкцию /гот. Измените тап.ру, чтобы он выглядел, как показано в ли- 
стинге 13.3. 


Листинг 13.3. Файл тат.ру 


# -*- соа1па: чЕЕ-8 -*- 
Его подо1е 1трог® * 

а = 2 

рг1 пе (а} 

1прие () 


Из модуля импортируется идентификатор а и в программе есть идентифи- 
катор а. Какое будет выведено значение? Здесь происходит слияние про- 
странств и все идентификатор попадают в одно общее пространство. Если 
программа использует идентификатор с таким же именем, то она переопре- 
делит его значение, поэтому будет выведено значение 2. 


При желании можно импортировать несколько идентификаторов. Как пра- 
вило, это делается, если нужно импортировать только интересующие иден- 
тификаторы. Пример: 


Егом шафН 1трог® (р1, Ноог, з1п, соз) 


13.4. Путь поиска модулей 


В каких каталогах Руоп будет искать модули? В самом простом случае 
модули размещаются в одном каталоге с вашей программой. В этом случае 
нет необходимости настраивать пути поиска, поскольку текущий каталог 
автоматически включается в путь поиска. 


Просмотреть текущий путь поиска можно с помощью следующих команд: 


>>> пирог зуз 

>>> зуз.раЕй 

['', 'Е:\\Рубпоп\\Т1Ь\\191е115', 'Е:\\Руброп\\руЕПоп392.21р', 'Е:\\ 
РуЕНоп\\РЪЬз', 'Е:\\РуЕНоп\\116', 'Е:\\РуЕНоп', 'Е: \\РуЕНоп\\11\\ 
з31$е-раскадез ' ] 

>>> 


Р\поп. Полное руководстес 


Путь поиска программ состоит из текущего каталога, пути поиска стандарт- 
ных модулей, переменной окружения РУТНОМРАТН и содержимого р®- 
файлов (они должны находиться в каталоге 141Ъ\зКе-расКарез, имя файла 
может быть любым, но расширение должно быть .рВ). Один из самых про- 
стых способов добавить нужные каталоги в путь поиска — это создать р@- 
файл. Перейдите в каталог 11Ь\$Це-расКарез, создайте файл, скажем, раз. 
рЕ и добавьте в него нужные пути поиска -— по одному в каждой строке: 


С: \ргодесЕ\му_1165 
С: \руевоп\му ру 


Второй часто используемый способ пути поиска модулей - изменение пере- 
менной окружения РУТНОМРАТН. 


13.5. Повторная загрузка модулей 


Модуль загружается только один раз — при первой операции импорта. Все 
последующие вызовы йпрой будут возвращать уже загруженный объект мо- 
дуля, даже если сам модуль был изменен. Допустим, вы изменили модуль, 
как его загрузить заново? 


Для этого нужно использовать функцию теа4() из модуля ипр: 


Егом 1пр ШпрогЕ ге1оаа 
ге1оаа (<модуль>) 


13.6. ЕСС-файлы 


Сложные расширения (вроде Ру?) состоят из множества модулей, поэто- 
му для простоты распространения таких пакеты принято распространять 
в виде ЕСС-файлов. Такие пакеты можно скачать на сайтах разработчи- 
ков пакетов-расширений. Разберемся, как их можно установить: 


1. Скачайте ерр-файл и поместитеего в каталог с:\Руфоп\Г1Ь\$Ке-расКарез\ 


2. Выполните из этого каталога команду: 


| 254 2 с оне ре ноьанень ооо оное ае че оенен Е : 
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РуЕПоп еазу 1п$%а11.ру -2 <ЕСб-файл> 
Например, 
Руепоп еазу_1п5%а11.ру -й руЕ2.еда 


Команда должна выглядеть именно так: 


РУуЕВоп еазу_1п$%а11.ру -2 <ЕСС-файл> 


А не так (как показано в некоторых руководствах): 


РуЕВоп еазу_1п5%а11 -2 <ЕСб-файл> 


Ввод этой команды приведет к ошибке. 


3. Просмотрите вывод команды. В случае успеха вы должны увидеть строку 
Е1п1зреЯ ргосезз1п9 Черепаепс1ез Еог <название модуля> 


13.7. Разделение модуля на 
несколько файлов 


Пусть у нас есть модуль, который нам нужно разделить на несколько фай- 
лов. Необходимо это сделать, не повредив существующий код, сохраняя 
отдельные файлы объединенными как единственный логический модуль. 


Программный модуль можно разделить на отдельные файлы, превратить 
его в пакет. Рассмотрим следующий простой модуль: 


# пумодо1е.ру 
с1азз А: 
ЯеЕ +ез+ (зе1): 
рг1пе('А.+ез®') 
с1азз В(А): 
Яе{ Ъаг (зе1{): 
рг1п*('В.Баг') 


Предположим, что вы хотите разбить тутод4е.ру на два файла — в каждом 
будет собственное определение класса. Чтобы сделать это, начните с заме- 
ны файла тутодще.ру каталогом тутодиЕЁ. В этот каталог поместите два 


— 
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пуподи1е/ 
__ 9101 _.рУу 


В файл а.ру поместите этот код: 


# а.ру 
с1азз А: 
АаеЕ +ез+ (зе1 Е): 
рг1пе('А.кезе') 


В файл Бру поместите этот код: 


# Ь.ру 
Егом .а 1троге А 
с1азз В(А): 
АеЕ Баг (зе1 Е): 
рг1п*('В.Раг') 


Наконец, в файл _ ш® ру поместите код, соединяющий все это вместе: 


# _ 1016 „ру 
Егом .а роге А 
Егом .Ь проге В 


Если вы сделаете эти действия, в результате будет пакет тутодше, который 
будет представлен как единственный логический модуль: 


>>> пирог& шуто4и1е 
>>> а = шутоаие.А() 
>>> а.+езЕ () 

А.сезЕе 

>>> Ь = шутоаи1е.В() 
>>> ЬБ.Баг() 

В.раг 

>>> 
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Нужно определиться, хотите ли вы, чтобы пользователи работали с боль- 
шим количеством маленьких модулей или с одним большим модулем? На- 
пример, в большой базе кода, можно просто разбить большой модуль на 
несколько меньших, но в резульгате пользователи должны будут использо- 
вать много операторов импорта, например: 


Егом шупо4о1е.а 1трогф А 
Егош пупоао1е.Ъ 1трог® В 


Это работает, но создает определенные неудобства для пользователя, кото- 
рый должен знать, где расположены различные части. Часто проще объеди- 
нить все в один модуль и использовать единственный оператор импорта: 


Егом пупоЧи1е 1прогЕ А, В 


Для нашего последнего примера нужно думать о тутойше как об одном 
большом исходном файле. Однако этот раздел показывает, как объединить 
несколько файлов в единственное логическое пространство имен. Ключ к 
достижению этого результата — создание каталога пакета и использование 
файла __ ши___ру для объединения частей. 


Когда модуль будет разделен, вы должны обратить особое внимание на пе- 
рекрестные ссылки. Например, в этом разделе, класс В должен получить 
доступ к классу А как к базовому. Чтобы получить такой доступ, использу- 
ется относительный импорт .а ппрог А. 


Всюду по разделу используется относительный импорт, чтобы не указывать 
жестко имя модуля верхнего уровня в исходном коде. В результате будет 
проще переименовать модуль или переместить его в другое место. 


13.8. Создание отдельных 
каталогов импорта кода под общим 
пространством имен 


На этот раз у нас есть много кода, разделенного на части и, возможно, об- 
служиваемого и распределяемого разными людьми. Каждая часть кода ор- 
ганизована как каталог файлов, подобно пакету. Однако вместо тог О, чтобы 


Рупоп. Полное руководство а а ОыЕ е. ру поп 


установить каждую часть как отдельный именованный пакет, вы хотите, 
чтобы все части были объединены ПОД ОДНИМ общим префиксом пакета. 


По существу, задача заключается в том, что нужно определить пакет Ру оп 
верхнего уровня, который служит пространством имен для большого ко- 
личества отдельно сохраняемых подпакетов. Эта проблема часто возникает 
в больших фреймворках, где разработчики хотят поощрить пользователей 
распределять плагины или дополнительные пакеты. 


Чтобы объединить отдельные каталоги под общим пространством имен, 
нужно организовать код в виде обычного пакета, но опустить файлы __ 
ши ру в каталогах, где будут объединяться компоненты. Рассмотрим не- 
большой пример. Предположим, что у вас есть два разных каталога кода: 


Еоо-раскаае/ 
сез®/ 
1а.ру 


Баг-раскаде/ 
сезе/ 
гип.ру 
В этих каталогах имя #5 используется как общее пространство имен. Обра- 
тите внимание, что здесь нет файлов __ШЁ__ ру - ни в одном из каталогов. 


Теперь посмотрим, что произойдет, если вы добавите оба каталога — 
юо-расКазе и Баг-расКазе — в модуль РуПоп и попытаетесь вызвать некото- 
рые операторы импорта: 


>>> ипрогЕ зуз 

>>> зуз.рафЬ .ехфепа ( ['Хоо-раскаде', 'Ьаг-раскаде'!]) 
>>> ипроге +езе.1а 

>>> пирогЕ фезе.гиап 

>>> 


Вы заметите, что, словно по волшебству, два разных каталога объединятся 
вместе, и вы сможете импортировать {е5ё.14 и {езё.гип. Это работает просто. 


Здесь используется особенность, известная как "пакет пространства имен" 
(патезрасе расКаге). По существу, пакет пространства имен — специаль- 
ный вид пакета, который используется для слияния различных каталогов 
кода под общим пространством имен, как показано в решении. Это может 
быть полезно для больших платформ, поскольку позволяет разбивать части 
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платформы в отдельные загрузки. Также это позволяет легко создавать сто- 
ронние дополнения и другие расширения для таких платформ. 


Ключ к созданию пакета пространства имен — убедиться, что в каталоге 
верхнего уровня нет файлов __шй___ру. Благодаря отсутствию файлов 
_ Ш ру при импорте пакета происходит интереснейшая вещь. Вместо 
ошибки интерпретатор начинает создавать список всех каталогов, которые, 
оказывается, содержат соответствующее имя пакета. Потом создается спе- 
циальный модуль пакета пространства имен, а копия (доступная только для 
чтения) списка каталогов сохраняется в переменной __рав__. Например: 


>>> ипроге фезЕ 

>>> фезЕ. _раеВ _ 

_МамезрасеРа*1 ( [ "Ёоо-раскаде/+езе', "'Баг-раскаде/+ез+']) 
>>> 


Каталоги в ра __ используются при определении местоположения даль- 
нейших субкомпонентов пакета (например, при импорте (е5ё.тит или #езё44). 


Важная функция пакетов пространства имен - то, что любой может расши- 
рить пространство имен с помощью своего собственного кода. Например, 
представим, что вы создали собственный каталог кода: 


пу-раскаче/ 
сезе/ 
сазвом.ру 


Есливы добавите ваш каталог с кодом в зуз.раёВ вместе с другими пакетами, 


ТО ОН будет беспрепятственно объединен с другими каталогами пакета 1е$:: 


>>> ипрогЕ фезе. сизбот 
>>> Иипроге фезе.гип 
>>> Ипроге фезе.1а 

>>> 


Проверить, является ли пакет пакетом пространства имен, можно посред- 
ством анализа его атрибута __Ё]е__. Если этот атрибут отсутствует, значит, 
пакет является пакетом пространства имен. Также строка представления 
будет содержать слово "патезрасе": 
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>>> Еез+. _В1е__ 


Тгасераск (мозЕ гесепЕ са]11 ]аз®): 
Е1]е "<зЕа1п>", 11те 1, 11 <поай1е> 


АЕЕг1рибеЕггог: 'пшо4у1е' об]есЕ Ваз по аеЕг1Биаке ' _Н1е_' 
>>> фезёЕ 

<поа11е '$е5Е' (памезрасе)> 

>>> 


13.9. Перезагрузка модулей 


Для перезагрузки ранее загруженного модуля используйте ппр.геоа4(). 
Например: 


>>> проге +езЕ 

>>> проге 1пр 

>>> Шар .ге1оаа ($ез+) 

<поЯа1е '6езе' ЁЕком './везе.ру!> 
>>> 


„Перезагрузка модуля очень полезна при отладке и разработке, но не очень 
безопасна в производственном коде, поскольку не всегда работает так, как 
вы ожидаете. 


За сценой операция теюаа() стирает содержимое базового словаря модуля и 
обновляет его, заново выполнив код модуля. Идентификационные данные 
самого объекта модуля остаются неизменными. Таким образом, эта опера- 
ция обновляет модуль везде, где он был импортирован в программу. 


Однако операция теоа4() не обновляет определения, которые были импор- 
тированы с использованием операторов, таких как "от тодше 1тротЕ пате. 
В качестве примера рассмотрим следующий код: 


# сезе.ру 

ае{ Ъаг(): 
рг1п®('Раг') 

ае{Е гоп (): 
рг1п®('гап') 


Теперь запустим интерактивный сеанс: 


>>> ипрогЕ ЕезЕ 
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>>> Его езЕ проге гап 
>>> фезе.Бахг () 

Баг 

>>> гиап() 

гап 

>>> 


= ру{воп 


Не выходя из Руоп, отредактируйте исходный код {езё.ру, так чтобы 
функция гип() была такой: 


ае{ гоп (): 
Рг1пе('Мем гип!) 


Теперь вернемся в наш интерактивный сеанс, выполним перезагрузку мо- 


дуля и повторим этот эксперимент: 


>>> ипрокЕ р 

>>> ипр.ге1оаа (%ез®) 

<по9о1е '+ез®' Егом './+езЕ.ру'> 
>>> +ез+.Ъаг() 

Баг 

>>> гап () # Старый вывод 
гап 

>>> фезе.гиап () # Новый вывод 
Мем гип 

>>> 


В этом примере, как вы успели заметить, загруженный две версии функции 
гип(). Обычно это не то, что вам нужно и в итоге простые на первый взгляд 
вещи приводят, в конечном счете, к головной боли. 


Именно по этой причине нужно стараться избегать использования пере- 
загрузки модулей в производственном коде. Пусть она останется уделом 
отладки и использования в интерактивных сеансах, где вы можете экспери- 
ментировать с кодом без выхода из интерпретатора. 


РУпоп. Полное руководство Ооо 2: руПоп 


13.10. Создание каталога или 2- 
архива, выполняемого как главный 
сценарий 


Иногда программы разрастаются и состоят из множества файлов. А Вы бы 
хотели получить простой способ выполнения этой программы? 


Если ваша программа состоит из множества файлов, вы можете поместить 
ее в отдельный каталог и создать файл __ таш___.ру. Например, вы можете 
создать подобный каталог: 


пуарр1 1са1оп/ 
тезе.ру 
БРаг.ру 
гап.ру 
_ ма1п__ «ру 


Если в каталоге присутствует файл __таш___.ру, вы можете запустить ин- 
терпретатор просто так: 


$ руЕРоп3 муарр11саЕ1оп 

Интерпретатор автоматически запустит файл __таш__ру как основной 
файл программы. Данная техника также работает, если вы запакуете весь 
ваш код в /1р-архив. Например: 


$ 15 
сез®.ру Раг.ру гип.ру _ па1п__.ру 
$ 21р -к муарр.21р *.ру 
$ руЕпоп3З муарр.21р 
вывод из _ па1п_.ру ... 


Создание каталога или 21р-архива и добавление файла __таш__.ру - один 
из возможных способов упаковки большого Руфоп-приложения. Данный 
способ отличается от упаковки кода в пакет, поскольку код не предназна- 
чен для использования в качестве модуля стандартной библиотеки. Вме- 
сто этого данный способ позволяет создавать пакеты Руоп-кода, которые 
могут быть легко выполнены кем-то еще. 
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Так как каталоги и р-архивы отличаются от обычных файлов, вы можете 
также добавить сценарий оболочки, чтобы упростить выполнение вашего 
кода. Например, если ваш код находится в архиве туарр.21р, вы можете соз- 
дать следующий сценарий оболочки: 


#!/изх/Ь1п/епу руВоп3З /п5г/1оса1/Ъ1п/муарр.21р 


13.11. Добавление каталогов в $у$. 
ра 


Иногда приходится работать с кодом, который не может быть импортиро- 


ван Руфоп, потому что расположен в каталоге, не перечисленным в 5уз.ра(®. 
Вам нужно добавить новые каталоги в зуз.ра( В, но вам не хочется делать это 
в своем коде. Что делать? 


Есть два общих способа добавить новые каталоги в зуз.рай В. Первый заклю- 
чается в использовании переменной окружения РУТНОМРАТН. Например: 


$ епу РУТНОМРАТН=/зоше/41г: /оЕВег/Я1г руВоп3 

Туре "соруг190е", "сгеа1е5" ог "11сепзе()" Рог моге 1пЕогта®1оп. 
>>> ипрогЕ зуз 

>>> зуз.раеь 

['', '/зоме/алг', '/о&вег/а1г'!, ...] 

>>> 


В пользовательском приложении эту переменную окружения можно уста- 
новить при запуске программы или через сценарий оболочки. 


Второй способ — создать файл ‚р, который перечисляет необходимые ка- 
талоги, например: 


# пуарр11са&1оп.реВ 
/зоме/а1г 
/оспег/а1г 


Этот .рВ файл нужно поместить в один из каталогов °Це-расКарез, который 
обычно находится в /изг/1оса|/ПЬ/руВоп3.9/Ке-расКаёез или -/.оса|/ 
ПЬ/руВоп3.9 /зКерасКарез. 


При запуске интерпретатора каталоги, перечисленные в .р-файле, будут 
добавлены в зу$.раВ (если они существуют в файловой системе). Уста- 
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новка .р®-файла может потребовать прав администратора, если он добав- 
ляется в общесистемный каталог (/изг/1оса|/ПЬ/руоп3.9/зЦе-расКарез). 


Столкнувшись с подобной проблемой, первое, что приходит в голову - 
написать код, вручную корректирующий значение зу$.раВ, например: 


проге зуз 
зуз.раеВ.1пзеге (0, '/зоте/41к') 
зуз.раеВ.1пзеге (0, '/офВек/а1г') 


Хотя это работает, такой подход чрезвычайно хрупкий и рекомендуется его 
избегать. Проблема в том, что вы явно указываете в своем коде имена ка- 
талогов. В результате рано или поздно это приведет к проблеме - когда 
код будет перемещен в какое-то другое расположение. Лучше сконфигури- 
ровать путь в другом месте и так, чтобы его можно было изменить, не 
редактируя исходный код вашей программы. 


Иногда вы можете использовать подобный способ, но только в случае, 
если вы надлежащим образом создаете абсолютный путь, например, 
используя переменные уровня модуля, такие как __ Ве _. Например: 


проге зуз 
гот оз.раВ 1троге аБзрафВ, 5)о1п, Я1гпате 
зуз.раеь.1пзек+ (0, аБзрафь (41гпаже ('_Я1е '), 'згс')) 


В результате каталог згс будет добавлен в путь корректным образом: вы не 
указываете абсолютный путь, а формируете его на основании переменной 
Не. 


Каталоги зЦе-расКарез содержат сторонние модули и пакеты, установлен- 
ные в вашей системе. Как правило, все сторонние модули и пакеты уста- 
навливаются в эти пакеты. Не смотря на то, что р-файлы находятся в 
этих каталогах, они могут ссылаться на любые каталоги в системе. Таким 
образом, реально ваш код может находиться за пределами каталогов зЦе- 
расКавез, пока его местоположение указано в .р\-файле. 


13.12. Распространение пакетов 


Вы написали полезную библиотеку, и вы хотите сделать ее доступной дру- 
гим. Первым делом нужно придумать вашей библиотеке уникальное имя и 
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очистить структуру каталогов. Например, типичный пакет библиотеки мо- 
жет выглядеть примерно так: 


рго)есепате/ 
ВЕАШМЕ . Е хе 
Рос/ 
аосцтепфа1ол . хе 
рго)ес+паме/ 
__ 111 РУ 
Фоо.ру 
Ьаг.ру 
16113/ 
__1101 _.ру 
фез*.ру 
гоп.ру 
ехапр1ез/ 
Ве11омог1А.ру 


Чтобы сделать ваш пакет пригодным к распространению, напишите файл 
зебир.ру, который выглядит примерно так: 


$ зебор.ру 
Его 413816118.соге Иипроге зееар 


зеЕтр (паще='рго)ес6паше', 
уегз1оп='1.0', 
апЕРог='Ваше имя', 
азВог_ета11='уоцвехашр1е.сом', 
иг1='В р: //мми.уоц.сош/ргозесепапе', 
раскадез=['рго)есЕпате', ''рго-)есфпаше .118113'], 


) 


Далее нужно создать файл МАМГЕЕ$ Та, в котором перечислены различ- 
ные файлы, не имеющие отношения к исходному коду: 


$ МАМТЕЕЗТ .1п 

2пс1аае *.ехе 
гесигз1уе-1пс1а4е ехапр1ез * 
гесогз1уе-1пс1а4е Бос * 
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Убедитесь, что поместили файлы зеир.ру и МАМТЕЕ$ Тала в каталог верх- 
него уровня для вашего пакета. Далее, чтобы создать дистрибутив пакета, 
введите команду: 


$ руЕроп3 зебир.ру $913%е 


В результате будет создан файл вроде ртойестате-1.0.ар или ртолестате- 
1.0.4ат'22 — в зависимости от платформы. Если все работает, вы можете 
отправить этот файл кому-то или же загрузить в индекс пакетов Руфоп 


(Пирз//рургрутоп.отв/рур). 


Для чистого кода Руфоп написание файла зеир.ру — несложное занятие. 
Один тонкий момент в том, что вы должны вручную перечислить каждый 
подкаталог, хранящий файлы с исходным кодом. Часто программисты ука- 
зывают только каталог верхнего уровня пакета и забывают описать под- 
компоненты пакета. Это неправильно! Это - то, почему спецификация для 
пакетов в зебир.ру содержит список расказез=['ргодесёпташте’, 'ргодесёлате. 
и@15']. 

Большинство программистов РуШФоп знает, что есть множество других 
(сторонних) средств создания дистрибутива пакета, в том числе 5еёироо[5. 
Некоторые из-них являются заменой библиотеки 455 и могут быть 
найдены в стандартной библиотеке. Знайте, что если вы полагаетесь на эти 
пакеты, то пользователи не смогут установить ваше программное обеспече- 
ние, если они также не установили требуемый диспетчер пакетов. Старай- 
тесь сохранять вещи максимально простыми. Как минимум, убедитесь, что 
ваш код может быть установлен, используя стандартную установку Ру оп 
3. Дополнительные функции могут поддерживаться опционально, если 
доступны дополнительные пакеты. 


ГЛАВА 14. 


ОБРАБОТКА. 
ИСКЛЮЧЕНИИ 
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14.1. Что такое исключение? 


Исключение — это извещение интерпретатора об ошибке в программном 
коде или о каком-то другом событии. Если в коде программы вы не предус- 
мотрите обработку исключений, то выполнение программы будет прервано 
и будет выведено сообщение об ошибке. 


Существует три типа ошибок: синтаксические, логические и ошибки времени 
выполнения. Первый тип ошибок - самый простой. Это ошибки в синтак- 
сисе языка, как правило, интерпретатор предупреждает о наличии таких 
ошибок, а выполнение программы будет прервано. Простота этих оши- 
бок в том, что интерпретатор сообщает в какой строке ошибка и вам остает- 
ся лишь исправить ее. 


Логические ошибки — более коварны. С точки зрения синтаксиса все нор- 
мально, но вот результаты работы программы не соответствуют ожидае- 
мым. Понять, что в программе ошибка можно только после анализа работы 
программы. | 


Ошибки времени выполнения возникают во время выполнения програм- 
мы. Причинатакихошибок -— события, не предусмотренные программистом. 
Например, вы создали функцию деления двух чисел и не предусмотрели, 
что на 0 делить нельзя. В результате, если передать в качестве делителя 0 
Ф 
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то возникнет ошибка деления на ноль - это классическая ошибка времени 
выполнения: 


>>> а = 10/0 
ТгасерасКк (тоз® гесепе са11 1аз®): 
Е11е "<рузве11#9>", 111е 1, 1п <поао1е> 
а =: 19../-0 
2егор1\151опЕгког: @1\151оп Бу 2его 
>>> 


Если вы не предусмотрите обработку исключения ето ляоптЕттот, то вы- 
полнение вашей программы будет прервано. 


Второе частое событие — это И{иеЕтог. Оно может возникнуть, если под- 
строка не найдена: 


>>> "Не11о" .1паех ('11') 
ТгасерасКк (тоз® гесепЕ са11 1аз®): 
Е11е "<рузве11#10>", 11пе 1, 11 <поа1е> 
"Не11о".1паех ('51') 
Уа1аеЕггог: зарзег1па поЕе Еоппа 


При работе со списками, кортежами могут возникнуть ошибки таехЁЕтот — 
когда вы пытаетесь получить доступ к несуществующему элементу списка: 


эр аге, <З 
>>> а[6] = 1 
Тгасераск (позе гесепЕ са11 1аз®): 
Е11е "<рузве11#12>", 11пе 1, 11 <поал1е> 
а[6] = 1 
ТпаехЕггог: 1156 азз1апщепЕе 1паех опЕ оЁ гапде 
>>> 


14.2. Типы исключений 


Разные типы ошибок генерируют разные типы исключений. Как было пока- 


зано ранее, при попытке открыть несуществующий файл, было сгенериро- 
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вано исключение Е1 1емоЕЕопп9Еггог, а при попытке преобразовать ЧИСЛО 
в строку — Уа1щеЕггох. 


Разные типы исключений представлены в таблице 14.1. Всего существует 
более 20 исключений, мы же рассмотрим только самые популярные. 


Таблица 14.1. Самые распространенные исключения 


Генерируется, если невозможно выполнить опера- 
ЦИЮ ввода/вывода 


Генерируется, если в последовательности не найден 
элемент с заданным индексом 


КеуЕггог Если в словаре не найден указанный ключ 
МатеЕггог Если не найдено имя (переменной или функции) 


бущахЕггог Если в коде обнаружена синтаксическая ошибка 
о Если стандартная операция применяется к объекту 
УР неподходящего типа 
Если операция или функция принимает аргумент с 
УашеЕггог р фу р ргу 
неподходящим значением 


Пего Пу! оп итог Если есть деление на 0 


В Рушфоп вы можете использовать следующие встроенные классы исклю- 
чений: 


» ВазеЕхсерИоп - начиная с Руоп 2.5, является классом самого верхне- 
го уровня 


» ЕхсерИоп — именно этот класс, а не ВазеЕхсерНоп, необходимо наследо- 
вать при создании пользовательских исключений 


» АззегиопЕггог — возбуждается инструкцией а55е7т 
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АйгЬщеЕ!гтог — попытка обращения к несуществующему атрибуту объ- 
екта 


ЕОЕЕггог — возбуждается функция шриГ() и гам триб) при достиже- 
нии конца файла 


ТОЕ:тог — ошибка доступа к файлу (ошибка ввода/вывода) 

ГтрогЕггог — невозможно подключить модуль или пакет 
шдещаНопЕггог — неправильно расставлены отступы в программе 
п4ехЕггог — указанный индекс не существует в последовательности 
КеуЕ!ггог - указанный ключ не существует в словаре 
КеуБоагаНиеггире — нажата комбинация клавиш Си1+С 

МатеЕггог — попытка обращения к идентификатору до его определения 


ЗюрИцегайоп — возбуждается метод пехЕ() как сигнал об окончании 
итерации 


ЗутахЕигтог — синтаксическая ошибка 
ТуреЕггог — тип объекта не соответствует ожидаемому 


ОпБоипаГоса[Еггог — внутри функции переменной присваивается зна- 
чение после обращения к одноименной глобальной переменной 


Опсо4де)есо4деЕтог — ошибка преобразования обычной строки в 
Отусо4е строку 


ОпюсодеЕпсодеЕггог — ошибка преобразования Описоде строки в обыч- 
ную строку 


УашеЕггог — переданный параметр не соответствует ожидаемому значе- 
нию 


ХегоПлу11опЕггог — попытка деления на ноль 


Иерархия классов исключений выглядит так: 


ВазеЕхсер®1оп 
СепегакогЕх1Е (в Рукпоп 2.6 и выше) 
КеуБоагаТпеегхгоре 
ЗузбемЕх1 Е 
Ехсер®1оп 
бепегабогЕх1е (в РубПоп 2.5) 
ЭЗБорТЕега®1оп 
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Магп1па 
ВубезИагп1па (в Руероп 2.6 и выше) 
Рергеса®1опЙагп1па, Габагейагп1па, ТирогЕМагп1па 
Репа1парергеса*1опМагп1па, Кап®1теМагп1па, 
ЗупЕахИагп1п9 
Оп1соаемагп1па, ОзегМагп1па 
ЗЕапаакаЕггог 
Аг1 Е рмее1сЕггог 
Е1оа*1паРо1пЕЕггог, ОуегНомЕггохг, 
2егор1\1$1опЕггог 
Аззеге1опЕггог 
АБЕЕ1расеЕкггкохг 
ВоНегЕггог (в РуЕПоп 2.6) 
Епу1 гопмепЕЕггкохг | 
ТОЕГГОГ 
ОЗЕГгкоЕ 
М1паоизЕггог 
ЕОЕЕГГОЕГ 
ТирогЕЕггог 
ТооКарЕггог 
ТраехЕгког, КеуЕггог 
МепогуЕггог 
МамеЕггог 
ОпьоппаГоса1Еггкох 
КеЕегепсеЕггог 
КипЕ1меЕггог 
МоЕТир1етепееяЕггог 
ЗупЕахЕггохг 
]паепеа*1опЕгкохг 
ТаБЕггог 
ЗузЕсемЕггог 
ТуреЕггог 
Уа1цеЕггог 
Ур1соаеЕккок 
Оп1соаересоаеЕггог, Оп1соаеЕпсоаеЕггог 
Оп1соаеТгапз1афеЕггог 


Мы можем заставить интерпретатор реагировать не на все исключения, а 
только на определенные, например: 


Листинг 14.1. Пример обработки УашеЕггог 


Ее 
К = 106 (1приё ("Введите целое число: ")) 
рг1п®е ("Вы ввели: ", К) 

ехсерЕ Уа1аеЕггог: 
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рг1пё ("Нужно ввести целое!!!") 


Здесь МЫ обрабатываем исключение определенного типа. При необходимо- 
СТИ МОЖНО обработать несколько исключений: 


Листинг 14.2. Пример обработки нескольких исключений 


ху: 
а = 11% (1приф ("Введите целое а: ")) 
Ь 110% (1приф ("Введите целое Ъ: ")) 
рг1пе("а/ь = ", а/Ь) 
ехсере Уа11еЕггог: 
рг1п® ("Нужно ввести целое!!!") 
ехсерЕ 2егор1\131опЕгког: 
рг1пё ("Деление на 0!") 


Да, можно обрабатывать все исключения подряд, не указывая тип исклю- 
чения в ехсереё. Но если вы будете обрабатывать только определенные ис- 
ключения, то можете указать разные сообщения пользователю - так вы сде- 
лаете свою программу информативнее. 


Гибкость Руоп в том, что он может передать в вашу программу свое ру- 
гательство, то есть сообщение об ошибки, но при этом программа не будет 
прервана. Это называется передачей аргумента исключения (лист. 14.3). 


Листинг 14.3. Передача аргумента исключения 


Егу: 
а 106 (1приф ("Введите целое а: ")) 
}®) 106 (1приф ("Введите целое БЬ: ")) 
рг1пе ("а/ь = ", а/Ъ) 
ехсерЕ \а1аеЕггог: 
рг1п® ("Нужно ввести целое!!!") 
ехсере 2егор1\131опЕггког аз е: 
рг1п® ("Деление на 0!") 
рг1п® ("Сообщение Ру&Воп:") 
рг1п® (е) 


И 


Нарис. 14.1 показано, что кроме наших сообщений самим Ру оп будет вы- 
ведено сообщение (#15оп бу гето. 


РУоп. Полное руководство ООО 2: рутпоп 


1 ЕЕ $пей 3.9.2 О х 


Бе ЕФИ Звен бебиа Орвоп5 УИтаом Не 
Русвоп 3.9.2 ($а95/%3.9.2:1а79785, Ееь 19 2021, 13:44:55} [М5С м.1928 64 Бе (АМ ^ 
064}] оп м1132 

туре "пе?р", "соруг146®", "сгеЯ1{5" ог "11сепзе(}" Гог тоге 1пРогта&1оп. 


>>> 


Введите целое а: 9 
Введите целое Ъ: 0 
Деление на 0! 
Сообщение Рубпоп: 
@1151оп Бу тего 
>>> | 


Рис. 14.1. Сообщение об ошибке интерпретатора вместе с пользо- 
вательским сообщением 


14.3. Инструкция 1ту. .ехсерт. .е5$е.. 
НпаНу 


Инструкция у используется для обработки исключений. Формат ин- 


струкции следующий: 


Еку: 
<Код, в котором могут возникнуть исключения> 
ехсер+ [<Исключение1> [аз <Объект исключения>]]: 
<Код, выполняемый при перехвате исключения 1>] 


ехсерЕ [<ИсключениеМ№> [аз <Объект исключения>]]: 

<Код, выполняемый при перехвате исключения М>] ] 
е15е: 

<Код, который будет выполнен, если исключение не возникло>] 
Нра11у: 

<Код, который будет выполнен в любом случае>] 


Теперь рассмотрим пример обработки исключения деления на ноль: 
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а = 10 / 0 

ехсере 2егор1\1$1опЕггог: 
рг1пЕ ('2егор1\у151опЕггог') 
а = 0 

рг1п® (а) 


В результате вместо сообщения об ошибке будет выведена строка 
7его Поп Еггог (можно ее и не выводить -— она предназначена для нас) и 
выведен 0 в качестве результата. 


Инструкция работает так: если в блоке ху возникает исключение, управле- 
ние передается блоку ехсерё. Вы можете указать несколько блоков ехсерь, в 
каждом из которых будут описаны действия, которые будут выполнены при 
том или ином исключении. В блоке е]зе указывается код, который будет 
выполнен, если исключение не возникло, а в блоке йпаЦЙу указывается код, 
который будет выполнен в любом случае. 


Вот как можно использовать блоки е[5е и йпаЙу: 


уу: 
х = 10/0 
ехсере 2егор1\1$1опЕггог: 
рг1пе ('2егор1\у151опЕггог') 
е15е: 
рг1пе ('Оператор Е1зе') 
Нра11у: 
рг1пе ('Оператор Е1па11у') 


Сначала выполните этот код как есть. Вы увидите вывод: 


2егор1\131опЕггог 
Оператор Е1па11у 


Затем замените 0 на 5: 


х = 10 / 5 


Вы увидите другой вывод: 


Оператор Е15е 
Оператор Е1па11у 


ея $2 ручвол 
14.4. Инструкция МИ .. аз 


Язык Руоп поддерживает протокол менеджеров контекста. Данный про- 
токол гарантирует выполнение завершающих действий (закрытие файлов, 
сокетов) вне зависимости от того, произошло ли исключение внутри блока 
кода или нет. 


Данный менеджер удобно использовать в следующем случае. Представим, 
что вы пишете код, который выполняет исключительную блокировку фай- 
ла. Где-то в середине этого кода происходит исключение. В результате вы- 
полнение сценария будет прервано, а файл так и останется заблокирован- 
ным. Менеджер контекста позволяет в любом случае надлежащим образом 
закрыть файлы и сетевые соединения. 


Для работы с менеджером контекста как раз и используется инструкция 
ший..а5. Формат ее следующий: 


м1ЕВ <Выражение1> [аз <Переменная>][, ..., 
<ВыражениеМ\№> [аз <Переменная>]]: 
<Код, в котором перехватываются исключения> 


Сначала вычисляется выражение 1, которое должно возвращать объект, ко- 
торый поддерживает протокол. Данный объект должен иметь два метода: 
_ ещег _(и _ е{ _ (). Метод __ ещег__() вызывается после создания 
объекта. Значение, возвращаемое этим методом, присваивается перемен- 
ной, указанной после ключевого слова а$. Если переменная не указана, воз- 
вращаемое значение игнорируется. Формат метода ._сепег _(): __ епег__ 


(зе1{). 


После этого выполняются инструкции внутри тела инструкции ший. Если 
при выполнении возникло исключение, то управление будет передано ме- 
тоду __ех®___(). Метод имеет следующий формат: 


__ех1Е  (зе1Ё, <тип исключения>, <значение>, «объект &гасераск>) 


Значения, доступные через эти три параметра, полностью эквивалентны 
значениям, которые возвращаются функцией ехс_ш®() из модуля $3. 
Если исключение обработано, метод должен вернуть Ёие, в противном слу- 
чае — Аабе. Если при выполнении операторов, расположенных внутри \%НВ, 
исключение не возникло, управление передается методу _ех{ _ (). В этом 
случае три параметра будут содержать значения №пе. 
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с1аз$ бапр1еС1азз: 
АеЕ _ епбег_  (зе1ЕЁ): 
рг1пЕ ('Епфег') 
тебагп зе1Е 
ЧеЕ _ ех1®_  (зе1Е, Туре, Уа1ае, Тгасе): 
рг1пе ('Ех1е') 


1Е Туре 15$ М№опе: # Исключения не было 
рг1п® ('Нет исключений') 

е1зе: 
рг1п® ('Значение = ', Уа1ое) 


гебагп Еа1зе # Га1зе - исключение не обработано 


м1ЕБ Запр1еСТаз$ (): 
рг1пё ('Внутри') 
га1зе ТуреЕггохг ('ТуреЕггог Ехсер®1оп') 


Последний оператор генерирует исключение вручную, чтобы проверить, 
работает ли наш объект или нет. 


Некоторые встроенные объекты, например, файлы, по умолчанию поддер- 
живают протокол. Вот пример работы с-файлом: 


м1ер ореп('109.%хе', 'а') аз Е: 
Е.мг1ее ('Еггог') 


14.5. Генерирование исключений 


Программист может сам сгенерировать исключение — или пользователь- 


ское или встроенное, например, как ранее было показано, мы генерировали 
исключение ТуреЁЕтог. Для этого используется инструкция тайе: 


га1зе <Экземпляр класса> 

га1зе <Название класса> 

га1зе <Экземпляр или название класса> Ёгом <Объект исключения> 
га1зе 
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Пример: 


>>> га1зе Уа1пеЕгког ("ТпЕо") 
ТгасеБасК (мозф гесепЕ са11 1аз$): 
Е11е "<рузве11#13>", 110е 1, 1п <тоао1е> 
газлзе Уа1пеЕггохг ("ТпЕо") 
Уа1пеЕгког: ТпЕо 
>>> 


А вот как можно обработать это исключение: 


су: 
газзе Уа1аеЕгкохг ("ТпЕо") 


ехсерЕ Уа1иеЕгког аз пза: 


рг1п (м9) #Выведет: ТпЁЕо 


Кроме габе есть еще и инструкция а55еп, которая аналогична следующему 
коду: 


1Е _ аебоя__ 
1Е поЕ «логическое выражение>: 


га1зе Аззег&1опЕгког (<Инфо>) 


Пример: 


ху: 

х = -5 

аззехе х >= 0, "Егкок" 
ехсерЕ АззехгЕ1опЕгког аз егг: 


рг1п (егг) # Выведет Еггог 


На этом все и можно перейти к чтению следующей главы, в которой будет 
рассмотрен файловый ввод/вывод. 


ГЛАВА 15. 


ФАЙЛОВЫЙ ВВОД/ВЫВОД 


Рушеп. Полное руководство ооо е руПоп 


До этого момента мы хранили обрабатываемые данные только в перемен- 
ных. Переменные - это хорошо, но они уничтожаются при завершении ра- 
боты программы, а данные часто нужно хранить постоянно — даже если про- 
грамма завершена или компьютер перезагружен. 


15.1. Работа с файлами 
15.1.1. ОТКРЫТИЕ ФАЙЛА 


Открыть файл можно с помощью функции ореп(), которая имеет следую- 


щий формат: 


ореп (Н1е, по4е='г', БиНег1па=-1, епсоа1п9=Мопе, еггогз=Мопе, 
пеи11пе=М№опе, с1озеЁа=Тгие, орепег=Мопе) 


Первый параметр задает путь к файлу. Его можно указывать, как относи- 
тельный, так и абсолютный. При указании абсолютного пути в \Лп9до\з 
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учитывайте, что символ \ является специальным и его нужно экранировать, 
например: 


"С: \\РуЕБоп\ \В1е. хе" # Правильно 
"С: \РубВоп\Н1е. хе" # Неправильно 


Если вы не заэкранируете слэши, то получите ошибку 1ОЕтог 


>>> Е = "С; \РуЕБоп\Н1е. хе" 
>>> ореп (Е) 
ТгасефасКк (позе гесепе са11 1азе): 
Е11е "<рузве11#1>", 11те 1, 1п <поао1е> 
ореп (Е) 
ОЗЕгког: [Еггпо 22] Тпуа11а агдамер®: 'С:\\РуВоп\х0Ос11е. хе! 
>>> 


Преобразовать относительный путь в абсолютный можно с помощью функ- 
ции а5райй() из модуля 0$.раёВ. Пример: 


>>> оз.раей.аБзрафН ("1пс1а4е\\аз*.В") 

'с: \\РуЕВоп39\\115\\191е115\\1пс1аде\\азе.в' 
>>> оз.раер.аБзраеП ("аз .В") 
'с:\\РуЕВоп39\\115\\191е11Ь\\азе.Нв' 

>>> 


Я все же рекомендую использовать абсолютный путь, а не относительный. 
Как видите, функция аб5рай() не всегда возвращает то, что нужно. В моем 
случае абсолютный путь к файлу выглядит так: 


с: \РуеВоп39\1пс1аае\а$*.В 


Однако функция аб5раЁй() попросту добавляет к указанному вами имени 
(пути) текущий путь, по которому выполняется программа (в данном слу- 
чае ГОГЕ). В некоторых случаях - это то, что вам нужно. В некоторых 
— нет. Поэтому не ленитесь и используйте абсолютный путь вместо от- 
носительного. 


После имени файла указывается режим его открытия: 
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® ‘г’ - только чтение (по умолчанию); 


® ‘\’ — запись, если файл существует, он будет перезаписан; 


® ‘х’_ эксклюзивный доступ, если файл существует, у вас ничего не вы- 
йдет; 


® ‘а’ _ дозапись в конец файла, удобно использовать, если файл уже суще- 
ствует. Если файл не существует, он будет создан; 


® '\’- двоичный режим; 
® '(_ текстовый режим (по умолчанию); 
® '+' — открывает файл для обновления (чтение и запись); 


® 'С- универсальный режим, уже не используется. 


Данные режимы можно комбинировать. Рассмотрим пример открытия 
файла в бинарном режиме для чтения: 


м1Ер ореп("зомеН1е. хе", "гЬ") аз ЕЁ: 
Вот амер Ее 
рке1пе (герг (11пе)) 


Имя файла и режим открытия — основные параметры. Остальные использу- 
ются довольно редко, но мы все же рассмотрим некоторые из них. Параметр 
БиЯегипя управляет политикой буферизации. Передайте в него 0, чтобы вы- 
ключить буферизацию вообще (используется только в двоичном режиме). 
Значение 1 включает буферизацию (доступно только в текстовом режиме). 
Другое положительное число задает примерный размер буфера, а отрица- 
тельное значение (или отсутствие значения) означает установку размера, 
применяемого в системе по умолчанию. 


Параметр еггог$ — это необязательный параметр, указывающий, как будут 
обрабатываться ошибки кодирования и декодирования в двоичном (бинар- 
ном) режиме. Если вам лень обрабатывать исключения ИзмеЕтот, укажите 
значение 1впоге’ для игнорирования ошибок. Значение ‘герасе' заставит 
функцию заменять каждый неизвестный символ знаком вопрос ?. 


Параметр пе\мйпе позволяет указать символ новой строки и применяется 
только к текстовому режиму. 


Очень полезен параметр епсо тв, который позволяет задать кодировку ин- 
формации в файле, например: 
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м1Ер ореп("зомен1е.Ехе", "а", епсоЯ1па="оЕЕ-8") аз Е: 
Е.игтее ("п1е.сепеег") 


м1Ер ореп("зомей1е. хе", "г", епсоЯ1па="оЕЕ-8") аз Е: 
Еог 11пе 11 ЕЁ: 
рг1пЕ (гер1 (11пе)) 


Остальные параметры вы вряд ли будете использовать, а если вы заинте- 
ресовались, зачем они используются, вы можете прочитать о них в руковод- 
стве по функции ореп(): 


йНр$://Чосзруфоп.ота/З/Пфтагу/ипсвопз/итИ#ореп 


15.1.2. МЕТОДЫ ДЛЯ РАБОТЫ С ФАЙЛАМИ 


После того, как файл открыт, вы можете использовать методы файлового 
объекта для работы с файлом: 


» с10озе() — закрывает файл. Интерпретатор автоматически закрывает 
файл при завершении программы, но явное закрытие файла считается 
хорошим тоном 


» утце(<данные>) — записывает данные (строку или последовательность 
байтов) в файл 


» утце|те$(<последовательность>) — записывает последовательность в 
файл. Если все элементы последовательности - строки, то файл можно 
открыть в текстовом режиме, в противном случае файл нужно открывать 
в бинарном режиме 


» геа4(<количество байтов>) — читает указанное количество байтов из 
файла. Если количество не указано, то возвращается содержимое файла 
от текущей позиции указателя до конца файла 


» геа4Ппе(<количество>) — считывает одну строку из файла при каж- 
дом вызове. Если файл открыт в текстовом режиме, возвращается стро- 
ка, если в бинарном — последовательность байтов. Вместо этого метода 
можно использовать его "служебную" версию __ пех __(), поскольку 
файловый объект поддерживает механизм итерации 


» НизП() - записывает данные из буфера на диск 


» Непо()- возвращает целочисленный дескриптор файла 
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{гипса е(<количество>) — обрезает файл до указанного количества 
символов 


(е!() - возвращает позицию указателя относительно начала файла в 
виде целого числа. В У\Лп4о\з метод #е[() считает символ \г дополни- 
тельным байтом, хотя этот символ и удаляется при открытии файла в 
текстовом режиме 


зееК(<смещение>[, <Начало>]) - устанавливает указатель в позицию 
<Смещение> относительно позиции <Начало>. В параметре <Начало> 
вы можете указать следующие атрибуты из модуля 10: 


10.3ЕЕК_ЗЕТ (0) - начало файла (по умолчанию) 
10.3ЕЕК_СОК, (1) - текущая позиция указателя 
10.3ЕЕК_ЕМО (2) - конец файла 


Теперь рассмотрим эти методы подробнее. Начнем с с/05е(). Руоп поддер- 
живает протоколов менеджеров контента, гарантирующий закрытие фай- 
ла вне зависимости от того, произошло исключение или нет. Пример: 


м1ЕВ ореп("зомеН1е.+хе") аз Ё: 


# 


Е.геаа () 
А здесь файл уже закрыт 


Далее рассмотрим пример записи в файл в текстовом и двоичном режимах: 


ным = ным = 


ыыы = 


Текстовый режим 
= ореп ("зомей1е. хе", "м", епсоа1па="и Е Е-8") 


„мг фе ("5Ег1па") 
.С1озе () 


Двоичный режим 
= ореп ("зомеН1е. хе", "м", епсоа1па="аеЕ-8") 


„мг фе ("5Ег1па\г\п") 
.СТозе () 


Запись нескольких строк 
= ореп("зомеН1е.ЕхЕ", "мр", епсо91па="аЕЕ-8")` 


„м1 е11пез ( ["5&х1п91\п", "5Ег1па2"] ) 
.Позй () # Сбрасываем буфер на диск 
.Сс1о5е () 
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Пример чтения из файла: 


\1ЕЬ ореп("зомеНн1е. хе", "г") аз ЕЁ: 
Е.геаа () 


# Побайтное чтение 

Е = ореп ("Н1е. хе", "г") 

Е. хеаа (10) # Читаем 10 байтов 

Е.геаа (10} # Читаем следующие 10 байтов 


рг1п% ("**Посимвольное чтение с кодировкой") 
фхЕ = ореп ("6ехЕ.Ехе", "г", епсоа1па=' а Е-8') 
рг1пЕ (Ех .геаа (1)) 

рг1пЕ (Ехе.геаа (2)) 

рг1пЕ (Ехе.геаа (6) ) 

фхе.с1озе () 


рг11п% ("**Читает весь файл в переменную сопфепе ") 
фхЕ = ореп ("Еехф.Ех®", "г", епсо@а1па='иЕ-8') 
сопвепЕ = Ехе.геаа () 

рг1п® (сопфепЕ) 

Е хе. с1о$е () 


рг1п% ("**Построчное чтение файла ") 

фхЕ = ореп("6ехе.6хе", "г", епсоЯ1па='аЕ-8') 
рг1п® (Е хе. геаа11пе ()) # Строка 1 

рг1пе (Ехе .геаЯ11пе ()) # Строка 2 
фхе.с1о5е () 


рг1пЕ("** Читает файл в список ") 
фхЕ = ореп("+ехЕ.+хе", "г", епсо@а1па='иЕ-8') 
11пез = Ех. геаа11пез () 


рг1п® (11пез) 

рг1пЕ (1еп (11пез)) 

Еог 11пе 1п 11пез: 
рг1п® (11пе) 


Е хе. с1озе () 


рг1пё("** Построчное чтение всего файла:") 
фхЕ = ореп ("вехё.Ехе", "г", епсоа1па=' а Е-8') 
Еог 11пе 11 хе: 

рг1п® (11пе) 
фхе.с1о5е () 


Ру{поп. Полное руководство = МООИ [ ру1поп 


Мы только что рассмотрели, как читать информацию из файла, как записы- 
вать ее в файл посредством высокоуровневых методов файлового объекта. 
В большинстве случаев этого достаточно в 90% случаев. Если вам нужны 
низкоуровневые функции для работы с файлами, вы найдете их в модуле 
0$: 


рр: /Аосзруйоп.оте/З.1/Пбтату/озйти 


15.1.3. ФУНКЦИИ ДЛЯ МАНИПУЛИРОВАНИЯ 
ФАЙЛАМИ 


Кроме методов записи и чтения файла в РуШоп есть функции манипули- 


рования целыми файлами -— копирования, удаления, перемещения файлов 
ит.д. Все рассматриваемые в этом разделе функции копирования и переме- 
щения находятся в модуле Ви. 


Функция соруШе() позволяет скопировать содержимое файла в другой 
файл. Речь идет именно о содержимом, никакие метаданные вроде прав до- 
ступа при этом не копируются. Если файл-назначение существует, он будет 
перезаписан. Если файл скопировать не удалось, вы получите исключение 
ТОЕтот. Синтаксис функции: 


соруНТе (<Источник>, <Назначение>) 


Пример: 


проге з09611 
$Вие11.соруН1Те ("Ё1е1.%х6", "ВН1е2.Ехе") 


Если нужно скопировать также права доступа, то нужно использовать 
функцию сору(). Поведение функции такое же, как и у сору/е(). Синтаксис 
тоже такой же: 


сору (<Источник>, <Назначение>) 


Функция сору2() копирует не только права доступа, но и остальные мета- 
данные: 
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сору2 (<Источник>, <Назначение>) 


Для перемещения файлов используется функция тоуе(): 


поуе (<Источник>, <Назначение>) 


Копирует файл в <Назначение>, а затем удаляет его. Если файл существу- 
ет, то он будет перезаписан. В случае ошибки возбуждается исключение 
ТОЕттог. Если файл нельзя удалить именно в УЛпдо\$, то генерируется ис- 
ключение Имдош$Етот (это исключение генерируется только в \УЛп4о\з, в 
других ОС генерируется только одно исключение — Итаош$ Ето"). 


Пример: 


1троге $6111 
рг1п® ("Перемещение файла...") 
фгу: : 
5пиЕ11.тоуе ("Н1е1.&хе", "В1е2.%хё") 
ехсерЕ Млпаомч$Еггог: 
рг1пё ("Ошибка при перемещении файла!") 
е1зе: 
рг1п® ("ОК") 


Далее мы будем рассматривать функции из модуля 0$. Для переименования 
файла используется функция гепате(): 


гепапе (<Старое имя>, <Новое имя>) 


Если исходный файл отсутствует или новое имя уже существует, то в 
МЛпао\из будет возбуждено исключение ИУтаош$Етот. Но поскольку 
УПпаошз$Етот наследует О5Егтот, то правильнее обрабатывать исключе- 
ние ОЗЕтог: 


1троге о$ 
фгу: 
о$.гепапе ('#Е1.аос', 'Е2.аос') 
ехсере О5ЗЕггог: 
рг1п® ('Ошибка! ') 
е1зе: 
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рг1пё('ОК') 


Для удаления файла используются функции тетоое() и ипйиК(): 


гетоуе (<имя файла>) 
ип11пк (<имя файла>) 


В случае ошибки обе функции генерируют исключение О5Ейтот. 
В модуле 0$.раф находятся следующие полезные функции: 


® ех1565(<имя>) — проверяет существование файла и возвращает ие, 
если файл существует 


» ре6$17е(<имя>) — возвращает размер файла. Перед вызовом этой функ- 
ции желательно проверить файл на существование 


» Бсеайте(<имя>) — возвращает время последнего доступа файла. Воз- 
вращается так называемая метка времени (Чтезатр) — количество се- 
кунд, прошедших с 1 января 1970 года 


» рейпите(<имя>) — возвращает время последнего изменения 


® ресите(<имя>) — возвращает время создания файла 


Пример: 


1прог® оз.раев 

1прогЕ Е1щме аз + 

поЯ_{1те = оз.раёП.деетЕ1те ("Ве11о.ру") 

рге1пе (6.56 ЕЕ1те ("%а.%т.%У %Н:%М:%5", &.1оса1%1те (тоа_&1те) ) 


Ранее вы уже были знакомы с одной функцией из модуля 0$.рай — аб5ра (). 
Кроме этой функции в этом модуле есть и другие функции преобразова- 
ния пути к файлу. Например, функция 1за6(<путь>) возвращает Пие, если 
указанный путь является абсолютным. А функция Базепате( <Путь>) воз- 
вращает базовое имя файла, то есть имя файла без пути к нему. А функция 
4ипате(<путь>), наоборот, возвращает путь без базового имени. Иденти- 
фикатор 5ер содержит разделитель элементов пути, используемый в вашей 
операционной системе. Примеры: 


>>> Егом оз.раЕВ 1рогЕ * 
>>> зер 
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"\\т 

>>> Базепапе ("с:\фепр\пе11о.ру") 
'ре1]о.ру' 

>>> а1гпапе ("С :\Еепр\Ве11о.ру") 
'С:\6епр' 


Обратите внимание: даже не смотря на то, что'я неправильно указал раз- 
делитель пути (поскольку я использую УЛп4о\з, то я должен был исполь- 
зовать разделитель \\, как показано выше), функции 0$.ра справились со 
своей задачей без ошибок и правильно определили базовое имя и название 
каталога, в котором находится файл. 


15.2. Работа с каталогами 


В модуле 0$ находятся также и функции для работы с каталогами. Начнем с 
функции десша(), которая возвращает текущий рабочий каталог: 


>>> Егом оз ШирогЕ * 

>>> деЕсиа () 
'С:\\РУЕПоп39\\Г1Ь\ \1а1е11ъ' 
>>> 


Функция сй4#() изменяет текущий рабочий каталог: 


>>> сра1г('с:\\езе') 
>>> деесиа () 
'с:\\$езе' 

>>> 


Для создания каталога нужно использовать функцию шКа!(<имя катало- 
га>[, <права доступа>]). Второй параметр не обязательный, он задает права 
доступа в ОМХ/пах. Если вы хотите его использовать, то нужно пере- 
дать трехзначное число в восьмеричной системе, например, 00777. О 
правах доступа мы поговорим в следующем разделе. Пример: 


>>> шкатгк ('а1г1') 


Рушпоп. Полное руководство г. РОН [2 руНоп 


Удалить пустой каталог можно с помощью функции гтдиг(<имя катало- 
га>). Обратите внимание: каталог должен быть пустым, иначе вы полу- 
чите исключение О5'Егтох. 


Вывести содержимое каталога позволяет функция 1570: 


>>> 1156 а1г (деесиа ()) 
чает, "1092'] 
>>> 


Обойти дерево каталогов можно с помощью функции ша/^(). Такая функ- 
ция стандартна для РуПоп и вам не придется изобретать велосипед заново. 
Формат функции: 


ма1К (<Начальный каталог>[, Фораомп=Ткое] 
[, опегког=М№опе] [, ЁЕо11ом11пКк$=Га1зе]) 


В качестве значения функция ша/() возвращает объект, на каждой итера- 
ции которого доступен кортеж из трех элементов — текущий каталог, список 
файлов и список каталогов. Параметр вордо\’п задает порядок обхода ката- 
лога — прямой или обратный. 


Пример: 


>>> Еог (а, Ь, с) 1п ма1К('с:\\6езе'): рг1п® (а) 


а: \везе 
с: \езе\а1г1 
>>> Еог (а, БЬ, с) 1п ма1К('с:\\%езе', Ка1зе): рге1п® (а) 


с: \езе\а1г1 
с: \Еезе 
>>> 


При обходе дерева каталогов полезно знать, какой перед нами элемент — 
файл или каталог. Функция 1570) возвращает ие, если обрабатываемый 
элемент — каталог. Аналогично, функция 15/{е() возвращает Тие, если об- 
рабатываемый элемент - файл: 
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>>> 15а1г('с:\\Еезе\\а1г1') 
Тгие 

>>> 15й1е('с:\\$езе\\91т1') 
Ра1зе 

>>> 


Обе функции находятся в модуле о$.раёЪ. 


Удалить дерево каталогов можно функцией пиёее() из зв: 


1трогЕ $6011 
гиегее ("с:\\фез%") 


15.3. Работа с файлами в разных 
форматах 


15.3.1. РАБОТА С СЗУ 


Данная глава концентрируется на использовании РуФфоп для обработки 


данных, представленных в разных форматах, например, в С$У, ]ЗОМ, ХМГ. 
и двоичных упакованных записях. Мы не будем рассматривать различные 
алгоритмы по обработке данных, но вместо этого мы рассмотрим способы 
ввода и вывода данных в программу и из нее. 


Формат СЗУ (Сотта-5ерапией Ициез) используется для хранения 
электронных таблиц. Например, вы можете экспортировать электронную 
таблицу Ехсе] в этот формат. Для большинства видов СЗУ-данных исполь- 
зуйте библиотеку с5у. 


Представим, что у нас есть некоторая электронная таблица в файле {аЫе. 
сзу. Вот код, который может обработать этот файл: 


1ирогЕ с$\ 


м1ЕВ ореп ('Еаф1е.сзу') аз Ё: 
Е сзу = сзу.геааег (Е) 
пеаЧегз = пехь (ЕЁ _сзу) 

Бог гом 11 ЕЁ с5у: 
# Обрабатываем строку 


Рупоп. Полное руководство и оо (а ру*Поп 


В предыдущем коде ряд будет кортежем. Поэтому для доступа к опреде- 
ленным полям вам нужно использовать индексирование, например, го\[0] 
(поле ЗутЬо]) и го\[4] (поле Срапве). 


Поскольку индексирование часто запутывает программиста, рассмотрите 
использование именованных кортежей. Например: 


Его со11есЕ1оп$ 1прог® памеаеор1е 


м1Е0 орел ('Еар1е.сзу') аз ЕЁ: 
Е с3у\у = сзу.геааег (Е) 
реаа1п9з = пехё (Е сзу) 
Воми = памеавар1е ('Вом', Пеаа1п9а$) 
Бо х ап Е < 3: 
гом = Ком (*г) 
# Обрабатываем строку 


В итоге вы можете использовать заголовки колонок вроде го\.Еит5 Маше и 
го\ ГазМате вместо индексов. Конечно, это только в том случае, если за- 
головки колонок являются допустимыми идентификаторами Руоп. Если 
это не так, обращаться к данным по заголовкам будет не очень удобно. 


Друг ая альтернатива — чтение данных как последовательности словарей. 
Чтобы сделать это, используйте ЭТОТ Код: 


1трогЕ с5\ 
мтЕр ореп ('6ар1е.сзу') аз ЕЁ: 
Е сзу = сзу.0О1сфВеааег (Е) 
Бог гом 1п Е С5У: 
# обрабатываем строку 
В этой версии получить доступ к элементам каждого ряда тоже можно с ис- 
пользованием заголовков. Например: го\['Е п Мате'| или го\['ГазМате']. 


Чтобы записать С$У-данные, вы также можете использовать модуль с$У, но 
создайте объект \гЦег. Например: 


Беааехгз = ['ОзегТО', 'Е1тузЕМаме', 'ГазЕМапе ' ] 
гом$ = [('13ех1', 'Зорп', 'Бое!), 
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('изег2', 'Фапе', 'Бое'’) 


] 


мтЕВ ореп ('изегз.сзу','м') аз ЕЁ: 
Е сзу = сзу.мгуфекг (Е) 
Е сзу.иг1еегом (реааегз) 
Е сзу.иг1егомз (гомз) 


По умолчанию библиотека сзу запрограммирована, чтобы понимать пра- 
вила кодирования С$У, используемые М!сгозой Ехсе]. Это наиболее рас- 
пространенный вариант и предоставит вам лучшую совместимость. Однако 
если вы обратитесь к документации по с$у, вы обнаружите, что есть воз- 
можность подстроить кодирование под разные форматы (например, изме- 
нить символ разделителя). Например, если вместо разделителя нужно ис- 
пользовать символ табуляции, используйте следующий код: 


м1ЕБ ореп('а5ег$.с$\у') аз Е: 
Е Езу = сзу.геадек(Е, Че11т1еег='\%') 
Бог гом 11 Е %3У: 
# Обрабатываем строку 


15.3.2. ЧТЕНИЕ И ЗАПИСЬ 4$ОМ-ДАННЫХ 


Модуль }з0п предоставляет простой способ кодировать и декодировать дан- 
ные в ]ЗОМ. Две основные функции - }507.4итр5() и }5оп.[оа45(), их работа 
похожа на других функций сериализации в других библиотеках, например, 
врсКе. 


]ЗОМ-кодирование поддерживает базовые типы данных — №пе, 6001, тё 
ЛоаЕ и 517, а также списки, кортежи и словари, состоящие из тех базовых ти- 
пов. Для словарей считается, что ключами будут строки (любые нестроко- 
вые ключи в словаре конвертируются в строки при кодировании). Чтобы 
быть совместимыми со спецификацией ]ЗОМ, вы должны кодировать толь- 
ко списки и словари. Кроме того, в веб-приложениях принято, что объект 
верхнего уровня является словарем. 


Формат кодирования ]ЗОМ почти идентичен синтаксису РуПоп за ис- 
ключением нескольких незначительных изменений. Например, ие ото- 
бражается в ие, Еабе - в /аЁе, а №пе - в пий. 


Вот как преобразовать структуру данных Ру'оп в ]ЗОМ: 


1проге )3зо0п 


Рупоп. Полное руководстто ООО #2: ру+поп 


Чафа = { 
'Незспапше' : "'ФоБп', 
'] азспаме' : 'Пое', 


'уеаг' ; 1979 
} 


)з0п_зЕг = )зо0п.Читрз (Чафа) 


А вот как вы можете преобразовать ]ЗОМ-закодированную строку обратно 
в структуру данных Рушфогп: 


Чака = )зоп.1оа4з ()5оп_5%г) 


Если вы работаете с файлами, а не строками, вы можете использовать 
функции ]50п.4итр() и1зоп.Доаа() для кодирования и декодирования ]ЗОМ- 
данных. Например: 


# Записываем 95ОМ-данные 

м1ЕР ореп('Ааафа.)5оп', 'м') аз ЁЕ: 
7зоп.аАитр (Чака, Е) 

# Читаем данные обратно 

м1Е1 ореп("'аафа.)зоп', 'г') аз Е: 
Чафа = )зоп.1оаа (Е) 


15.3.3. ПАРСИНГ ХМЕ-ФАЙЛОВ 


Для извлечения данных из простого ХМТ.--документа можно использовать 
модуль хп].етее.Е]етеп(Тгее. Чтобы проиллюстрировать, предположим, 
что вы хотите проанализировать и сделать сводку произвольной В$$- 
ленты, содержащей элементы ИЦе, ри6Оже, Пак. Вот сценарий, который 
делает это: 


Егом и:1116.геадаезЕ 1птроге иг1ореп 
Его хи1.есгее.Е1етепЕТгее 1прогЕ рагзе 


# Загружаем В55-ленту и парсим ее 

и = иг1ореп ('ВЕЕр://сайт/г$$20.хп]1') 

ос = рагзе (а) 

# Извлекаем и выводим интересующие теги 
Рог 16еш 1п аос.1Еегйпа ('сВаппе1/1$ем'): 
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{1Е1е = 16ем.Нпакехе ('{161е') 
Чафе = 1+ем.НпаЕехе ('рабраее') 
11ок 1$ем.Нпафехе ('11пк') 


рг1пё (161е) 
рг1п (ааее) 
ретпЕ (11пК) 
рг1п® () 


Очевидно, если вы хотите произвести дополнительную обработку, вам нуж- 
но заменить операторы рии: () на что-то более интересное. 


Работа с данными, представленными в виде ХМТ, осуществляется во мно- 
гих приложениях. Мало того, что ХМГ. широко используется в качестве 
формата для обмена данными в Интернете, также он является стандартным 
форматом для хранения данных приложения (например, при обработке 
текста, в музыкальных библиотеках и т.д.). Все сказанное далее предполага- 
ет, что читатель уже знаком с основами ХМГ. 


Во многих случаях, когда ХМГ, используется просто для хранения данных, 
структура документа компактна и понятна. Например, вот типичная К$5- 
лента: | 


<?хм1 уег$1о0оп="1.0"?> 
<г5$ Уег$10оп="2.0" хм1пз:Аас="ВЕр://ригк1.ога/ас/ 
е1емепЕз/1.1/"> 
<спаппе1> 
<Е1Е1е>8$5$ Ееед</&1%1е> 
<11пк>ВЕЕр: //сайт/</11пк> 
<1ападиаче>ги</1апдиаде> 
<аезск1рЕ1оп>Описание< /аезсг1рЕ1оп> 
<1{фем> 
<{1Е1е>Заголовок 1</%1&1е> 
<11пК>Ссылка 1</11пк> 
<аезск1рЕ1оп>Инфо 1</аезсг1рЕ1оп> 
<рабраЕе>Дата 1</риррафе> 
</1Еем> 
<1{$ем> 
<{1Е1е>Заголовок 2</&1&1е> 
<11пКкК>Ссылка 2</11пк> 
<аезск1рЕ1оп>Инфо 2</4езсг1рЕ1оп> 
<рабраЕе>Дата 2</рибрафе> 
</1Еем> 
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</спаппе1> 
</г33> 


Функция хт]|.егее.Еетеп{Тгее.рагзе() парсит весь ХМГ-документ в объ- 
ект документа. Вы можете использовать методы вроде диа(), йетртао и 
пех () для поиска определенных ХМГ-документов. Аргументы к этим 
функциям - имена определенных тегов, вроде сваппе|/Кет или ИЦе. 


При определении тегов вы должны принять полную структуру докумен- 
та во внимание. Каждая операция Йп4 работает относительно начального 
элемента. Аналогично, имя тега, которое вы передаете каждой операции, 
тоже указывается относительно начального элемента. В примере вызов к 
Чос.цегйпа(‘сБаппе|/кегт"”) находит все элементы "Иет", которые находят- 
ся внутри элемента "сраппе!". "4ос" представляет верхнюю часть документа 
(элемент "гз5"). Более поздние вызовы Йет.лиех(() будут иметь место от- 


носительно найденных элементов "Цет". 


У каждого элемента, представленного модулем ЕЙетеп:Тгее, есть несколь- 
ко существенных атрибутов и методов, которые полезны при парсинге. 
Атрибут фай содержит имя тега, атрибут фехё содержит текст, а метод ег () 
может быть использоваться для извлечения атрибутов. 


Нужно отметить, что хт|.егее.Е]етепТгее — не единственное средство 
для парсинга ХМГ. Для более сложных приложений вы можете рассмо- 
треть использование |хт!'. Эта библиотека использует тот же АР1, что и 
ЕетепТгее, таким образом, пример, показанный только что будет работать 
ис1[хп. Просто нужно заменить первый оператор импорта на #гот [хп1.еёгее 
проге рагзе.|хп. Библиотека [хп]! лучше совместима с ХМГ-стандартами. 
Также она быстрее и предоставляет дополнительные функции вроде вали- 
дации, ХУСТ и ХРа. 


15.3.4. ПРЕОБРАЗОВАНИЕ СЛОВАРЯ В ХМЕ 


Иногда нужно сохранить содержимое словаря в ХМГ.-формате. Хотя би- 
блиотека хп].ейгее.Е]етепЕТгее обычно используется для парсинга, она так- 
же может быть использована для создания ХМГ-документов. Например, 


рассмотрим эту функцию: 


Егош хи]1.ефгее.Е1етеп®Тгее 1прог® Е1ешеп+ 


1 ВИрз://рур1.рупоп.оге/рурИ хи! о 
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аеЁ 941сЕ во _хп1 ($ад, а): 


Преобразуем простой словарь из пар ключей/значений в ХМЬ 
ут 
е1ем = Е1емеп® ($ ад) 
ог Кеу, уа1 1п а.1%епз (): 
сЬ11а = Е1ептеп® (кеу) 
ср11а.вехе = зЕг (\уа1) 
е1еп.аррепа (сБ11а) 
гебагп е1ем 


Вот пример использования: 


>>> з = { 'паме': 'МагКк', "'зВагез': 70, 'рг1се!'!:590.1 } 
>>> е = а1сЕ во _хп1('6езе', $5) 

>>> е 

<Е1етепЕ '$езе' аб 0х1004564с8> 

>>> 


Результат этого преобразования — экземпляр Еетепё. Для ввода/вывода 
проще конвертировать это в байтовую строку, используя функцию ю0$7и8() 
в хп.егее.Е]етлеп(Тгее. Например: 


>>> Егом хи1.ебгее.Е1етепеТгее 1трогЕ бозег1па 

>>> бозЕг1па (е) 
Ь'<Еезё><рг1се>590.1</рг1се><зВагез>70</зрагез><паме>Магк</ 
папе></+ез%>' 

>>> 


Если вы хотите присоединитьатрибуты к элементу, используйте метод $е0: 


>>> е.зеё(' 1а','1234') 

>>> СозЕг1па(е) 

Ь'<ЕезЕ _14а="1234"><рг1се>590.1</рг1се><зрагез>70</ 
зрагез><паме>Магк</паме> 

</ЕезЕ>' 

>>> 


При создании ХМТ. программисты обычно просто создают ХМГ-строку. 
Например: 


аеЁ 491сЕ фо хм1 зЕг(фаа, а): 


т! 


Аналог нашей функции, но здесь просто создается ХМТ-строка 
тт! 


рагез = ['<{}>'.Еогмаф (ад) ] 
Гог Кеу, уа1 1п а.1%етз(): 
рагЕз .аррепа ('<{0}>{1}</{0}>'.Еогмаф (Кеу,уа1)) 
рагез$.аррепа ('</{}>'.Еогма® ($аа)) 
тебогп ''.)о1п (раг® 5) 


Проблема заключается в том, что вы можете запутаться, если попытаетесь 
заняться обработкой ХМТ.-файла вручную. Например, что произойдет, если 
значения словаря содержат специальные символы? 


>>> а = { 'паме' : '<зрам>' } 


>>> # Создание строки 

>>> а1сЕ о хм1 зЕг('1%ем',а) 
'<1сеп><паме><зращ></паще></1ееп>' 

>>> #4 Правильное создание ХМЬ 

>>> е = @1сЕ (о хи1 ('1{ет',а) 

>>> созЕг1па (е) 
Ь'<1Ееп><паме>&1Е; зрам&че; </паме></1Еем>' 
>>> 


Обратите внимание, как в последнем примере заменяются символы < и > 
на &6; и &56.. 


Для справки: если вы даже вам захочется вручную обрабатывать такие спе- 
циальные символы, вы можете использовать функции езсаре() и ипезсаре() 
в хш|.зах.захи 5. Например: 


>>> Егом хш1.зах.захи*11$ 1трог® езсаре, ипезсаре 

>>> езсаре ('<зрапм>') 

'&1Е;зрам&9е;' 

>>> ипезсаре (_) 

'<зрам>' 

>>> 

Кроме создания корректного вывода есть и другая причина, почему лучше 
создавать экземпляры Нетеп вместо строк — они могут быть легко объеди- 
нены вместе, чтобы создать большой документ. Результирующие экземпля- 
ры Еетепе также могут быть обработаны разными способами и при этом не 
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нужно волноваться о парсинге ХМГ.. По существу, вы можете сделать всю 
обработку данных в более высокоуровневой форме, а затем вывести его как 
строку в самом конце. 


15.3.5. МОДИФИКАЦИЯ И ПЕРЕЗАПИСЬ ХМЕ-КОДА 


Другая часто распространенная задача —- нужно прочитать ХМГ-документ, 
внести в него изменения и записать обратно как ХМГ.. 


Модуль хш|.егее.ЕетепЕТгее упрощает выполнение таких задач. По су- 
ществу, вы начинаете парсинг документа обычным способом. Например, 
предположим, что у вас есть документ, который называется ргед.хш| и по- 
хож на это: 


<?хш1 уегз1оп="1.0"?> 
<5Еор> 
<1а>14791</1а> 
<пт>Моя компания</пм> 
<5г1> 
<г&>22</г&> 
<4>Улица</4> 
<аа>Индекс</а4> 
</зх1> 
<сг>22</сг> 
<рге> 
‚ <р>5000</рЕ> 
<Еа>Тез*</Еа> 
<у>1378</\м> 
<гп>22</гп> 
</рге> 
<рге> 
<ре>10000</р+> 
<Еа>Тез*</Еа> 
<у>1867</\м> 
<гп>22</гп> 
</рге> 
</зеор> 
Далее приведен пример использования ЕетепТгее для чтения этого файла 
и внесения изменения в его структуру: 


>>> Егом хи1.есгее.Е1етеп®Тгее 1проге рагзе, Е1етепе 
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>>> ос = рагзе ('ргеа.хш1') 

>>> гооЕ = аос.деегоое® () 

>>> гооЕ 

<Е1етепЕ '56ор' аЕ 0х100770с0> 
>>> # Удаляем несколько элементов 
>>> гооф.гетохе (гоо®.Нпа ('$г1')) 
>>> гооф.гемохе (гоое.Нпа ('сг') ) 


>>> # Вставляем новый элемент после <йщ>..:.</йй> 
>>> гооЕ.деесв11аАгеп () .1паех (гоо®.Йпа ('пм')) 

1 

>>> е = Е1емепе ('5рам') 

>>> е.кехЕ = 'Тезе' 


>>> гооф.1п5ек® (2, е) 

>>> # Записываем результат обратно в файл 

>>> аос.мг1фе ('пемргеа.хи1', хи1_ Ааес1ага%*1оп=Ткие) 
>>> 


В результате этих операций будет создан новый ХМТ--файл, который вы- 
глядит так: 


<?хм1 уегз10оп='1.0' епсоЯ1п49='и$-а$с11'?> 
<$Фор> 
<1а>14791</1а> 
<пи>Моя компания</пм> 
<зрам>Тест</зрам><рге> 
<рё>5000</ре> 
<Еа>Тест</Еа> 
<у>1378</м> 
<гп>22</гп> 
</рге> 
<рге> 
<рё>1000</р+> 
<Еа>Тест</ Еа> 
<Уу>1867</\> 
<гп>22</гп> 
</рге> 
</зЕор> 


Изменение структуры ХМГ-документа достаточно простое, но вы должны 
помнить, что все модификации обычно делаются в родительском элементе, 
как будто это список. Например, если вы удаляете элемент, то он удаляет- 
ся из его непосредственного родителя, используя метод тетоое() родителя. 
Если вы вставляете или добавляете новые элементы, то вы также использу- 
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ете методы #15е7(() или аррепа() родителя. Элементами можно также управ- 
лять, используя индексы и слайсы, например, е|етеп{ [1] или е|етеп{[1:} |. 


Если вам нужно создать новые элементы, используйте класс Еетегь, как 
было показано. 


15.3.6. ДЕКОДИРОВАНИЕ И КОДИРОВАНИЕ 
ШЕСТНАДЦАТЕРИЧНЫХ ЧИСЕЛ 


Вам нужно декодировать строку шестнадцатеричных чисел в байтовую 
строку, или же кодировать байтовую строку как шестнадцатеричную. Для 
этого можно использовать модуль Мпазсй. Например: 


>>> # Начальная байтовая строка 
>>> з = Ь'ре11о' 

>>> # Кодируем в шестнадцатеричном виде 
>>> ипрогЕ Ю1паз$с11 

>>> п = р1пазс11.Ю2а_Пех ($3) 

>>> в 

р'68656сбс6Е' 

>>> # Декодируем в байты 

>>> Р1пазс11.а2Ъ пех (п) 
р'ве11о' 

>>> 


Подобная функциональность также может быть найдена в модуле Базеб4. 
Например: 


>>> парогЕ Базеб4 

>>> р = Базеб64.Б1бепсоае (3) 

>>> В 

Ь'68656С6С6Е' 

>>> Разеб4.5164есоае (1) 

р'ве11о' 

>>> 

По большей части преобразование в шестнадцатеричную форму и обрат- 
но с использованием описанных функций очень простое. Основное разли- 
чие между этими двумя методами в обработке регистра. Функции базеб4. 
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Ь164есо4е() и Базеб4.Ь 1бепсо4е() работают только с прописными шестнад- 
цатеричными буквами, тогда как функции в Мпазсй с любым регистром. 


Важно отметить, что вывод, произведенный функциями кодирования, всег- 
да является байтовой строкой. Чтобы привести его к Отсоде, нужно доба- 
вить дополнительный шаг декодирования. Например: 


>>> В = разеб4.51 бепсоае ($) 
>>> ретпЕ (В) 

Ь'68656С6С6Е' 

>>> рг1пё (В.аесоае ('а$с11') )} 
68656С6С6Е 

>>> 


При декодировании шестнадцатеричных чисел функции 6764есо4е() и 
а2ь йех() принимают или байты или Ошсоде-строки. Однако эти строки 
должны содержать АЗСП-кодированные шестнадцатеричные цифры. 


15.3.7. КОДИРОВАНИЕ/ДЕКОДИРОВАНИЕ ВА$ЗЕб 4 


Кодирование Вазеб4 используется на байтовых данных, такие как байто- 


вые строки и массивы байтов. Кроме того, результат кодирования всегда 
является байтовой строкой. Если вы смешиваете данные, закодированные 
в Вазеб4, с текстом Ошсоде, вам придется выполнить дополнительный шаг 
декодирования. 


В модуле Базеб4 есть две функции — 564епсо4е() и Ь64аесоае(), которые 
позволяют работать с Вазеб4-кодированием. Например: 


>>> # Некоторые байтовые данные 
>>> $ = Ь![Ве1]о' 
>>> парогЕ Разе64 


>>> # Кодируем как Вазе64 
>>> а = Базеб4.564епсоае (3) 
>>> а 

Ь'аСУзЬС8=' 


>>> # Декодируем данные из Вазе64 
>>> разеб64.664аесоае (а) 

Ь'ре11о' 

>>> 


ГЛАВА 16. 
ООП И РУТНОМ 
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16.1. Основы объектно- 
ориентированного 
программирования 


Объектно-ориентированное программирование (ООП) — это особый 
подход к написанию программ. Чтобы понять, что такое ООП и зачем оно 
нужно, необходимо вспомнить некоторые факты из истории развития вы- 
числительной техники. Первые программы вносились в компьютер с по- 
мощью переключателей на передней панели компьютера - в то время ком- 
пьютеры занимали целые комнаты. Такой способ "написания" программы, 
сами понимаете, был не очень эффективным -— ведь большая часть времени 
(несколько часов, иногда — целый рабочий день) занимало подключение 
кабелей и установка переключателей. А сами расчеты занимали считанные 
минуты. Вы только представьте, что делать, если один из программистов 
(такие компьютеры программировались, как правило, группами програм- 
мистов) неправильно подключил кабель или установил переключатель? 
Да, приходилось все перепроверять - по сути, все начинать заново. 


Позже появились перфокарты. Программа, то есть последовательность 
действий, которые должен был выполнен компьютер, наносилась на пер- 
фокарту. Пользователь вычислительной машины (так правильно было на- 
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зывать компьютеры в то время) писали программу, оператор "записывал" 
программу на перфокарту, которая передавалась оператору вычислитель- 
ного отдела. Через определенное время оператор возвращал пользователю 
результат работы программы - рулон бумаги с результатами вычислений. 
Мониторов тогда не было, а все, что выводил компьютер, печаталось на бу- 
маге. Понятно, если в расчетах была допущена ошибка (со стороны пользо- 
вателя, компьютеры ведь не ошибаются — они делают с точностью то, что 
заложено программой), то вся цепочка действий (программист, оператор 
перфокарты, оператор вычислительной машины, проверка результатов) по- 
вторялась заново. 


Следующий этап в программировании — это появление языка Ассембле- 
ра. Этот язык программирования позволял писать довольно длинные для 
того времени программы. Но Ассемблер - это язык программирова- 
ния низкого уровня, все операции проводятся на уровне "железа". Если вы 
не знаете, то сейчас я вам поясню. Чтобы в РНР выполнить простейшее 
действие, например, сложение, достаточно записать '$А = 2 + 2; '. На языке 
Ассемблера вам для выполнения этого же действия нужно было выполнить 
как минимум три действия - загрузить в один из регистров первое число 
(команда МОУ), загрузить в другой регистр второе число (опять команда 
МОУ), выполнить сложение регистров командой АОШ. Результат сложе- 
ния будет помещен в третий регистр. Названия регистров я специально 
не указывал, поскольку они зависят от архитектуры процессора, а это еще 
один недостаток Ассемблера. Если вам нужно перенести программу на ком- 
пьютер с другой архитектурой, вам нужно переписать программу с учетом 
особенностей целевой архитектуры. 


Требования к программным продуктам и к срокам их разработки росли 
(чем быстрее будет написана программа, тем лучше), поэтому появились 
языки программирования высокого уровня. Язык высокого уровня позво- 
ляет писать программы, не задумываясь об архитектуре вашего процессора. 
Нет, это не означает, что на любом языке высокого уровня можно написать 
программу, которая в итоге станет работать на процессоре с любой архи- 
тектурой. Просто при написании программы знать архитектуру процессора 
совсем не обязательно. Вы пишете просто А = В + С и не задумываетесь, в 
каком из регистров (или в какой ячейке оперативной памяти) сейчас хра- 
нятся значения, присвоенные переменным В и С. Вы также не задумывае- 
тесь, куда будет помещено значение переменной А. Вы просто знаете, что к 
нему можно обратиться по имени А. Первым языком высокого уровня стал 
ЕОКТКАМ (ЕОКшиа ТКАМ$асог). 


Следующий шаг — это появление структурного программирования. Дело в 
том, что программы на языке высокого уровня очень быстро стали расти в 
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размерах, что сделало их нечитабельными из-за отсутствия какой-нибудь 
четкой структуры самой программы. Структурное программирование под- 
разумевает наличие структуры программы и программных блоков, а также 
отказ от инструкций безусловного перехода (СОТО, ] МР). 


После выделения структуры программы появилась необходимость в созда- 
нии подпрограмм, которые существенно сокращали код программы. Намно- 
го проще один раз написать код вычисления какой-то формулы и оформить 
его в виде процедуры (функции) - затем для вычисления 10 резульгатов по 
этой формуле нужно будет 10 раз вызвать процедуру, а не повторять 10 раз 
один и тот же код. Новый класс программирования стал называться про- 


цедурным. 


Со временем процедурное программирование постигла та же участь, что и 
структурное программирование — программы стали настолько большими, 
что их было неудобно читать. Нужен был новый подход к программиро- 
ванию. Таким стало объектно-ориентированное программирование (далее 
ООП). 


ООП базируется на трех основных принципах - инкапсуляция, полимор- 
физм, наследование. Разберемся, что есть что. 


С помощью инкапсуляции вы можете объединить воедино данные и обра- 
батывающий их код. Инкапсуляция защищает и код, и данные от вмеша- 
тельства извне. Базовым понятием в ООП является класс. Грубо говоря, 
класс — это своеобразный тип переменной. Экземпляр класса (переменная 
типа класс) называется объектом. В свою очередь, объект — это совокуп- 
ность данных (свойств) и функций (методов) для их обработки. Данные и 
методы обработки называются членами класса. Свойства в Руоп называ- 
ются атрибутами класса, но также и есть понятие свойства класса, которое 
не нужно путать с классическим свойством. 


Получается, что объект — это резульгат инкапсуляции, поскольку он вклю- 
чает в себя и данные, и код их обработки. Чуть дальше вы поймете, как это 
работает, пока представьге, что объект - это эдакий рюкзак, собранный по 


Ун 


принципу "все свое ношу с собой". 


Теперь поговорим о полиморфизме. Если вы программировали на языке С 
(на обычном С, не С++), то наверняка знакомы с функциями а65(), /аБ5(), 
1а65(). Все они вычисляют абсолютное значение числа, но каждая из функ- 
ций используется для своего типа данных. Если бы С поддерживал поли- 
морфизм, то можно было бы создать одну функцию а65(), но объявить ее 
трижды - для каждого типа данных, а компилятор бы уже сам выбирал 
нужный вариант функции, в зависимости от переданного ей типа данных. 
Данная практика называется перезагрузкой функций. Перезагрузка 


8; руепоп есь Глава 16. ООП и Рупоп 


функций существенно облегчает труд программиста - вам нужно помнить 
в несколько раз меньше названий функций для написания программы. 


Полиморфизм позволяет нам манипулировать с объектами путем создания 
стандартного интерфейса для схожих действий. 


Осталось поговорить о наследовании. С помощью наследования один объ- 
ект может приобретать атрибуты другого объекта. Заметьте, наследование — 
это не копирование объекта. При копировании создается точная копия объ- 
екта, а при наследовании эта копия дополняется уникальными атрибутами 
(новыми членами). Наследование можно сравнить с рождением ребенка, 
когда новый человек наследует атрибуты своих родителей, но вто же время 
не является точной копией одного из родителей. 


16.2. Определение класса и 
создание объекта 


Определить класс можно с помощью ключевого слова с1а$5: 


с1аз$ <Название класса>: 
<Описание атрибутов и методов> 


Пример определения класса: 


с1а55 батшр1еС1а$$:; 
её __ 111% (зе1Е): 
рг1 пе ("СопзЕгисфог") 
5е1Ё.пм = "бапр1еС1а$5" 
ЧеЁ рг1пЕМапе (зе1ЕЁ); 
рг1 пе (зе1Ё.пм) 


оЬ) = бамр1еС1аз$ () 
о) .рг1пЕМапе () 


# При желании вы можете самостоятельно вывести атрибут 
рг1 пе (05) .пм) 


Если запустить этот код, то его вывод будет следующим: 


>>> 

Сопзегасвог 
бапр1еС1а$$ 
бапр1еС1а$5 


РУпоп. Полное руководстто ООО 2: рукпоп 


Строка Сопбисфог выводит только один раз — во время создания объекта 
об}. Далее выводятся две строки Затр/еС]азз. Одна — когда мы используем 
метод рипё\Мате(), вторая - когда мы выводим атрибут объекта. 


Как видите, формат обращения к методам и атрибутам следующий: 


<Объект> .<Метод> ( [Параметры] ) 
<Объект>.<Атрибут> 


Также для доступа к атрибутам вы можете использовать следующие функ- 
ЦИИ: 


» деайг)- возвращает значение атрибута по его названию, которое ука- 
зывается в виде строки 


® зай") — устанавливает значение атрибута. Название атрибута задает- 
ся в виде строки 


» (ей) -— удаляет атрибут, название, как обычно, задается в виде строки 


®» Пазай’() — проверяет наличие указанного атрибута. Если атрибут суще- 
ствует, возвращается ие 


Синтаксис данных функций следующий: 


дефа{ тг (<Объект>, <Атрибут>[, <Значение по умолчанию>]) 
зетае ег (<Объект>, <Атрибут>, <Значение>) 

ела ег (<Объект>, <Атрибут>) 

Раза г (<Объект>, <Атрибут>) 


16.3. Конструктор и деструктор 


Конструктор -— это метод, вызываемый интерпретатором автоматически 
при инициализации класса. В Руфоп этот метод называется п __(): 


ЧеЕ __ 111 _ (5е1Е[, <Значение1>[, .., <Значением№>]]: 
<Инструкции> 


Конструктор используется для инициализации атрибутов класса. Также 
конструкторы могут выполнять некоторую подготовительную работу, на- 
пример, открывать файлы, устанавливать соединения — все зависит от 
специфики вашей программы. 
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Аналогично, перед уничтожением объекта вызывается деструктор, который 
в Руоп называется __4е] __(). Учитывая, что интерпретатор сам заботит- 
ся об освобождении занимаемых объектом ресурсов, особого смысла в де- 
структоре нет. 


16.4. Наследование 


Наследование - это то, за что программисты любят ООП. Наследование 
позволяет создать класс, в котором будет доступ ко всем атрибутам и мето- 
дам родительского (базового) класса, а также к некоторым новым методам 
и атрибутам. 


Рассмотрим неболыной пример: 


с1азз Рагепе: #$ Родительский класс 
АеЕ рг1п®_папе (зе1Е) : 
рг1пе ("Родитель") 


с1азз СВ11Аа (Рагеп+) : # Наследование класса Рагепе 
АеЕ рг1пе_сп119 (5е1Е): 
рг1пЕ ("Потомок") 


ор) = СЬ11а() 
ор) .рг1пЕ паме () 
ор] .рг1п®е_ср11а () 


Посмотрите, что у нас получилось. Класс СЬИА унаследовал метод рип _ 
пате(), который мы можем вызвать из объекта оБ}. 


Примечание. Терминология разная. Поэтому в некоторых ис- 
точниках родительский класс могут называть базовым, а также 
суперклассом. Дочерний класс называют подклассом или произ- 
водным классом. 


А что, если в дочернем классе вам захочется определить такой же метод, как 
и в родительском? Например: 


с1азз Рагеп*: # Родительский класс 
АеЕ рг1п®_паме (зе1 Е): 
рг1п® ("Родитель") 


с1азз Ср11а(Рагеп+) : # Наследование класса Рагепе 
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аеЕ рх1пе_сЬ1149(8е1Е): 
рг1п® ("Потомок") 

аеЕ рг1п®е_ папе (5е1Е): 
рг1п® ("Потомок") 


о) = Св11а() 
ОБ) .рг1пЕ папе () 


Какой метод будет вызван? Будет вызван метод дочернего класса, посколь- 


ку он переопределит метод с таким же именем родительского класса. Если 
нужно вызвать именно метод родительского класса, тогда нужно явно ука- 
зать имя класса, например: 


АеЕ рг1п паме (5е1Е): 
рг1п® ("Потомок") 
Рагеп®.рг1п® _паме () 


Примечание. Конструктор родительского класса автоматически 
не вызывается, если он переопределен в дочернем классе! 


В РуФоп также доступно и множественное наследование - когдаодин класс 
наследует атрибуты и методы нескольких классов. Просто нужно указать 
родительские классы в скобках через запятую: 


с1азз Ср11а(Рагеп*1, РагепЕ2): 
<Определение класса, как обычно> 


16.5. Специальные методы 


Классы в Руфоп поддерживают представленные в таблице 16.1 специаль- 


ные методы. 


Таблица 16.1. Специальные методы 


_ са] (зе, Параметру,... | Обрабатывает вызов экземпляра класса как 
‚ПараметрМ]) вызов функции 
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__ зецет___ (зе <Ключ>, | Будет вызван при присваивании значения по 
<Значение>) индексу или ключу 


Вызывается при доступе к значению по ин- 
дексу или ключу. Метод будет автоматически 

__ веет __ (зе, <Ключ>) | вызван при использовании операций, при- 
менимых к последовательностям, например, 
при использовании цикла ог 


Вызывается при удалении элемента по индек- 


| < > 
еее, Ко) су или ключу с помощью оператора 4е1 


__ реайг _ (зе Вызывается при обращении к несуществую- 
<Атрибут>) щему атрибуту класса 


__ веаииЬ ще __ (зе Ё, Вызывается при обращении к любому атри- 
<Атрибут>) буту класса 


__ зебайг _ (зе {, <Атрибут>, | Вызывается при попытке присваивания зна- 
<Значение>) чения атрибуту экземпляра класса 


Вызывается при удалении атрибута с по- 
мощью инструкции 4е1 <Экземпляр 
класса>.<Атрибут> 


__ Чеавг _ (зе, <Атри- 
бут>) 


Определяется только для объектов, поддер- 
живающих итерацию. Если в классе одно- 
временно определены методы _ Кег_()и__ 
веет___(), то предпочтение отдается методу 
_ ИЦег _(). Помимо метода __ Цег _() в клас- 
се должен быть определен метод __пехё _(), 
который будет вызываться на каждой итера- 
ции 


_ ег _ (зе 1) 


Вызывается при использовании функции 


_ еп __ (зе) |еп() 
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__ Боо| _ (зе! #) 


__ Йоае__ (зе) 


__ сотр/ех__ (зе) 


__ гоира _ (зе!) 


_ ш4ех__ (зе) 


__ терг__ (зе!) 


__ Разв__ (зе!) 


Вызывается при использовании функции 


Боо1() 


Используется при преобразовании объекта в 
целое число с помощью функции 1(() 


Используется при преобразовании объекта в 
целое число с помощью функции Йоаб() 


Вызывается при использовании функции 
сотр/ех() 


Вызывается при использовании функции 
гоипа() 


Вызывается при использовании функций 


ЫпС), Вех() и осб() 


Используется для преобразования объекта в 
строку. Вызывается при попытке преобразо- 
вать объект в строку в интерактивной обо- 
лочке, а также при использовании функции 


герг() 


Используется для преобразования объекта 
в строку. Вызывается при попытке преобра- 
зовать объект в строку при выводе объекта 
функцией рип); а также при использова- 
нии функции $%г(). Если метод __$__() не 
определен, то будет вызван метод __терг_ _(). 
Методы $ __()и __терг__() должны воз- 
вращать строку 


Используется, если объект класса планиру- 
ется использовать в качестве ключа словаря 
или внутри множества. Используется редко 
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Вы можете переопределить эти специальные методы так, как посчита- 
ете нужным - в зависимости от решаемой задачи. В качестве примера соз- 
дадим класс, поддерживающий итерацию. Для этого нам нужно переопре- 
делить методы _ Цег _()и__ пехе (): 


С1азз ТЕегС1азз: 

аеЁ. 111  (зе1Е, х): 
зе1Ё.маз$1\у = х 
зе1Е.1па = 0 # Индекс 

АеЕ __1%ег__ (зе1Е): 
гееагп зе1Е 

аеЁ __ пех® _ (зе1ЕЁ): 
1Е зе1ЁЕ.1па >= 1еп (зе1Ё.щазз1у) : 


зе1Ё.1па = 0 # Сбрасываем индекс 
га1зе ЗеорТ*ега*1оп # Генерируем исключение 
е1зе: 


1$еп = зе1Ё.паз$з1у[зе1Ё.1па] 
зе1Ё.1па += 1 
гесагп 1%ем 


053 = ТкекС1азз([1, 2, 3]) 
Бог 1 11 оБ]: 
рг1п® (1, епа=" ") # выведет 1 2 3 


16.6. Статические методы 


Внутри класса можно создать метод, который будет доступен без создания 
экземпляра класса. Для определения статического метода используется де- 
коратор @%айсте о4. Вызывается статический метод так: 


<Название класса>.<Название метода> (<Параметры>) 
Также статический метод можно вызвать и через объект класса: 
<Объект класса>.<Название метода> (<Параметры>) 


Пример: 


с1азз 5%а*1сбапр1е: 
@зкае1смеевоа 
аеЕ ззищ(х, у): 
гебагп х + у 
аеЕ шзим (зе1Е, х, у): 
гебагп х + у 


Ру!поп. Полное руководство = ООО (2 ру+воп 


рг1пе (5а*1сбам1е.ззим (2, 2)) $ Вызываем до объявления 
объекта | 

оь] = 5ЕаЕ1сбаптр1е () 

рг1п® (оБ) .мзим (2, 2)) $ Вызываем обычный метод 
рге1пе (05) .550м (2, 2)) # Вызываем статический метод 


через объект 


16.7. Абстрактные методы 


Абстрактные методы содержат только определение метода без реализации. 
Это эдакие заглушки, которые нужно реализовать в дочернем классе. Часто 
в абстрактных методах возбуждают исключение, чтобы напомнить о необ- 
ходимости реализовать метод, например: 


с1аз$ Запр1е: 
аеЕ Гипс (зе1Е, х, у): 
га1зе Мое Гир1етепееЯЕггохг ("Мое 1пр1епепееа“) 
аеЕ мзим (зе1Е, х, у): 
тгевигп х + у 


В данном случае метод /ипс() является абстрактным. Как видите, никаких 
декораторов не используется. Хотя в версии. 2.6 появился модуль абс; со- 
держащий декоратор @аБзгасетефо4. Что дает нам использование этого 
декоратора? А то, что вам не нужно вызывать самому исключение, данный 
декоратор сгенерирует ошибку ТуреЕггог при использовании не переопре- 
деленного абстрактного метода. Лучше использовать первый способ, но не 
привести пример с использованием @аБз(гасипео4 просто невозможно: 


Егом абс 1троге * 


с1аз5 бапр1е: 
@абзЕгасемеепоа 
аеЕ Гипс (зет1Е, х, у): 
разз 
аеЕ мзим (зе1Е, х, у): 
тевагп х + у 


16.8. Перегрузка операторов 


Перегрузка обычных операторов позволяет экземплярам классов участво- 
вать в обычных операциях вроде сложения или вычитания. Например, 
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если вы хотите сложить два объекта, то для их класса должен быть опреде- 
лен метод х. _а44__(у). Ниже приведен пример перегрузки операторов == 
и: 


с1аз$ Ве1оаЯС1а$5$: 

АеЕ 1101  (5е1Е): 
зе1Е.х = 0 
зе1+.а = [1 а, э3 

ЧеЕ _еа__ (зе1Е, х): 
гебагп зе1Ё.х == у 

АеЕ _ сопка1пз__ (зе1Е, у): 
гееигп у 1п зе1Ё.а 


о = Ве1оа@ЯС1азз$ () 


ЗЕ © == 1:0: 
рг1пЕ ("Тгие") 
е15е: 
рг1пё ("Еа1зе") # Выведет Га]1зе 


Е ЭН ©: 

рг1 пе ("Тгае") # Выведет Тгиае 
е1зе: 

рг1п& ("Ра1зе") 


Методы, используемые для перегрузки обычных операторов, приведены в 
таблице 16.2. 


Таблица 16.2. Методы перезагрузки обычных операторов 


| 


х. ааа _ 
хм | 


Ру!поп. Полное руководство ООО [= рувоп 


% 


х. _Игие ху (у) х/-=у 
х. _Иоогу (у) х//У 
к бот (у) 
х. _ то4__(у) х%у 
х. гтоа__(у) 
х. _ипо4__(у) 
х. _ро\__(у) 


х. _тро\__(у) ух 


ЕЕ: : НИ! 
х. _роз__() +х (унарный плюс) 
х.__е9 (у) 
х. пе (у) 
Хх. № < 
х._ в (У) 
х. _е_ (у) 
х._5е у) 
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16.9. Свойства класса 


Внутри класса может быть создан идентификатор, через который будут 
производиться операции по получению и изменению значения атрибута, а 
также операция удаления атрибута. Создать такой идентификатор моно с 
помощью функции рторепу(): 


<Свойство> = ргорегфу (<Чтение>[, <Запись>[, <Удаление[, <Строка>]]]) 


Первые три параметра определяют соответствующий метод класса. При 
чтении значения будет вызван метод, указанный в первом параметре. При 
попытке записи — метод, указанный во втором параметре. При удалении 
атрибута вызывается метод, указанный в третьем параметре. Если в каче- 
стве какого-либо параметра указано №пе, то это означает, что этот метод 
не поддерживается. Последний параметр - это строка документирования. 


Пример: 


с1аз5 Ргорегеубапр1еС1а$5: 
АеЕ 1116 (5е1Е, х): 
ЗЕЕ. р=.Х 
аеЕ дее р (зе1Е): 
гебогп 5е1Е. р 
аеЕ зеф_р(зе1Ё, х): 
зе1ЁЕ. р=х 
аеЕ ае1 р(зе1Е): 
Ае1 5е1Е._ р 
ргор = ргорегеу(деЕ_р, зеё р, ае1 р, "1щЕо") 


о = Ргорег®убатшр1еС1аз$ (1) 


рг1п® (о..ргор) # Вызывается метод дер 
о.ргор = 5 # Вызывается метод зе р 
е1 о.ргор # Вызывается метод ае1 р 


16.10. Декораторы класса 


Начиная с Руоп 3, кроме декораторов функций поддерживаются также 
декораторы классов, позволяющие изменить поведение обычных классов. В 
качестве параметра декоратор принимает ссылку на объект класса, поведе- 
ние которого необходимо изменить, и должен возвращать ссылку на тот же 
класс или какой-либо другой. Пример: 


аеЕ аесо (а) : 
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рг1пЕ ("Декоратор") 
гебагп а 


@аесо 
с1аз5$ батмр1еС1а$з: 
А4еЕ __ 1116  (5е1Е, уа1че): 
зе1Ё.\у = уа1ае 


о = Запр1еС1азз (1) 
рг1пЕ (о.м) 


ГЛАВА 17. 


РАБОТА С 
ИНТЕРНЕТОМ 


Рушоп. Полное руководство ООО г, руепоп 


17.1. Разбираем ЧВ|-адреса 


При написании Интернет-приложений часто может понадобиться разбор 
ОВГ-адреса. Общий формат ЧЕТ. следующий: 


<Протокол>: / /<Домен> : <Порт>/<Путь>; <Параметры> ?<Запрос>#<Яко 
рь> 


Для протокола ЕТР схема ЦКТ. выглядит так: 


<Протокол> : / /<Пользователь>: <Пароль>@<Домен> 


Для разбора ИВТ. в Рупоп используется функция иПратзе() из модуля 
и Б.рагзе. Синтаксис ее следующий: 


их1рагзе (<ОВ1-адрес>[, <Схема<[, <Якорь>]]) 
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Функция возвращает объект РагзеКези с результатами разбора ОВГ- 
адреса. Данный объект можно преобразовать в кортеж из следующих эле- 
ментов (зсВете, пе] ос, ра{®, рагатз, диегу, Навтепе). Данные элементы со- 
ответствуют схеме ОВГ-адреса: 


<зсреме> : //<пе*1ос>/<ра®П>; <рагамз>?<ацегу>#<ЁЕгадтеп®> 


Элементы: 


» свете — содержит название протокола. По умолчанию пустая строка. 
Доступно по индексу 0 


» пеЙос — название домена и номер порта. По умолчанию пустая строка. 
Доступно по индексу 1 


® Позбпате — только название домена (в нижнем регистре) 
® рок - номер порта 
® ра - путь. Доступно по индексу 2 


® рагатз — параметры. Значение доступно по индексу 3. По умолчанию - 
пустая строка 


® дцегу — строка запроса. Значение доступно по индексу 4 


» {тартепе — якорь. По умолчанию - пустая строка. Значение доступно по 
индексу 5 


® цзегпате — имя пользователя (если указано), по умолчанию — №те 


» разз\ог@ — пароль. Значение по умолчанию — №те 


Пример использования: 


>>> Егом иЕ111Б6.рагзе арог® * 

>>> иг! = иг1рагзе ("БЕЕр://п1е .сепеег:80/1паех .рпр;зЕ?ракгам=уа1ае#апког") 
>>> пгт 

Рагзекези1* (зсреме='ВЕЕр', пее1ос='п01е.сепеег:80', раЕВ='/1паех.рЬр', 
рагатз='з®е', адиегу='рагат=уа1ае', Егадчтепе='апког') 

>>> Е = Еир1е(ит1) 

>>> Е 

('ВЕЕр', 'п1е.сепег:80', '/1паех.рЬр', '3', "'рагат=уа]ае', 'апКог') 
>>> иг!.зсреме, иг1 [0] 

('ВЕБр', "ВЕбр') 

>>> иг1.пеЕ1ос, иг1 [1] 
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('мми.п1е.сепбег:80', "'ммм.п1е.сепеег:80') 
>>> иг1.РозЕпаме 
'016.сепеег!' 

>>> иг1.рогЕе 

80 

>>> иг]1.раев 
'/1паех.рЮр' 

>>> иг1.рагамз 
"ЗЕ" 

>>> иг1.апегу 
'рагам=уа1ае' 
>>> иг1. Егадмепе 
'апКог' 

>>> 


Для выполнения обратной операции, то есть для сбора О ВГ.-адреса из от- 
дельных частей используется функция ийип5рЁ Е: 


>>> Е = ('ВЕЕр', "'п1Е.сепеег', '1паех.рПр', "'раг=уа1ае', 'апКог') 
>>> иг1ап5р11 ({) 
'ВЕЕр://п1&.сепеек/1паех. рНр?раг=уа1ие#апКог"' 


17.2. Декодирование строки запроса 


Ранее мы получили строку запросов, которая выглядит так: 


параметр1=значение] &...хпараметрМ№=значениемМ 


Теперь нужно разобрать эту строку на составляющие. Сложность заключа- 
ется в том, что если значение содержит символы национальных алфавитов, 
то они будут закодированы — каждый символ будет кодироваться последо- 
вательностью символов $пп, где пп — шестнадцатеричное число. Пример: 


Вуз Лилрефа.от/Е/Х00%А8%100%В8%01%84% 01%80% 20% В 
Е% 00%В2%00%В0%р0%Вр% 20%В8%0%В5 


Для разбора строки запроса на составляющие можно использовать следую- 
щие функции из модуля иг ШЬ.рагзе: 


@®; ру+поп к Глава 17. Работа с Интернетом 


® рагзе_94$() - разбирает строку запроса и возвращает словарь с ключами, 
которые содержат названия параметров, и список значений 


»® рагзе_4$1() - в отличие от предыдущей функции возвращает список 
кортежей из двух элементов 


Синтаксис функций: 


иг1рагзе.рагзе_а5(а$[, Кеер Б1апК уа1оез[, 5%г1с® раг5$11п9]]) 
иг1рагзе.рагзе_а$1(аз[, Кеер _Ь1апК уа1аез[, з%г1с® рагз1п9]]) 


Пример: 


>>> Его иг111Ю.рагзе 1прогЕ рагзе_а5 


>>> 4$ = '5=%00%А8%р0%88%р01$%84%01%80%р00%ВЕ%00%В2%р00%8В0%р00%8В0%р 
0%8В8%р0%В5' 


>>> рагзе а$ (4$, епсо91п9='ср1251') 
199“ 'РЁРЁС „СВРЗРТР°РЗРЁРр' 1} 

>>> рагзе а$(4$, епсоЯ1па='аеЕ-8') 
{'з': ['Шифрование'] } 

>>> 


Как видно из примера, очень важно правильно указать кодировку. Как пра- 
вило, используется иё{-8, что и показано в примере. 


Если параметров несколько, то функции с легкостью справятся и с этой за- 
дачей: 


>>> а5 = 'раг1=уа11&раг2=\а12' 

>>> рагзе 4$ (4$, епсоЯ91па='а Е Е-8') 
{'раг1': ['\%а11'], 'раг2': ['у%а12']} 
>>> рагзе 451 (аз, епсоа1ва='аеЕ-8') 
[('раг1', 'уУа11'), ('раг2', '\а12')] 
>>> 


17.3. Разбор НТМЕ-эквивалентов 


В НТМГ-документах часто встречаются так называемые НТМТ- 


эквиваленты. Например, последовательность &51 соответствует знаку >, а 
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последовательность &1 - знаку <. Для работы с НТМГ-эквивалентами ис- 
пользуются функции модуля хт|.зах.захи 5: 


® езсаре() — заменяет символы <, >, & соответствующим им НТМГ- 
эквивалентами. Необязательный параметр <Словарь> позволяет ука- 
зать словарь, содержащий дополнительные символы в качестве ключей, 
аих НТМГ-эквиваленты - в качестве значений. 


® диобеавг() - аналогична езсаре(), но дополнительно заключает строку в 
кавычки или апострофы. Если внутри строки встречаются и кавычки, и 
апострофы, то двойные кавычки будут заменены НТМТ-эквивалентом. 


» ипезсаре() - заменяет НТМГ-эквиваленты &атр;, &[;, &56; обычными 
символами. Параметр <Словарь> позволяет указать словарь с дополни- 
тельными эквивалентами. 


Синтаксис: 


езсаре (<Строка>[, <Словарь>]) 
аоосеае ег (<Строка>[, <Словарь>]) 
ирезсаре (<Строка>[, <Словарь>]) 


Пример: 


>>> парогЕ хм1.зах.захи®11$ аз х 
>>> х.езсаре ('""<>5""') 
$ ТЕ &ЧЕ;&атр;"" ' 


17.4. Преобразование относительных 
ссылок 
Иногда в НТМГ-документах указывают относительные ссылки, а не абсо- 


лютные. Преобразовать относительную ссылку в абсолютную можно с по- 
мощью функции #710 () из модуля иг ПЬ.рагзе: 


иЕ1)] о1п («базовый иг1>, <относительный или абсолютный иг1> [, 
<Якорь>]) 
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Пример использования: 


>>> Егом иг111Ъ.рагзе 1троге иг1)]о1п 


>>> иЕ1)о1п ('ВЕЕр://п1е.сепЕег', '1п4аех.рЬр’) 
'ВЕЕр://п1е.сепеег/1паех.рНр' 
>>> иг1)о1п ('БЕЕр://п1Е.сепеег/1паех.ррр', '%езе.БЕт1') 


'ПЕЕр://п1е.сепеег/ вез .ВЕм1' 


17.5. Определение кодировки 


Документы в Интернете представлены в самых разных кодировках. В 
последнее время наблюдается тенденция использования единой кодиров- 
ки — ОТЕ-8 и это очень и очень хорошо. Определить кодировку документа 
можно по заголовку Сощеп{-Туре в заголовках сервера: 


СопЕепЕ-Туре: ЕехЕ/р&т1; спвахзее=иеЕ-8 
Также кодировка указывается с помощью МЕТА-тега сопепё: 


<пефа ПЕЕр-еаи1у="Сопкеп*-Туре" сопеепе="ех® /В&м1; 
сПагзее=иЕЕ-8"> 


К сожалению, далеко не все используют ОТЕ-8 и довольно часто кодировка 
из ответа сервера не совпадает с указанной в МЕТА-теге. Для определения 
кодировки можно использовать библиотеку сВаг4е%, скачать которую мож- 
но по адресу йёр://сратгаееееаратзеготе/аоштоаа. 


Скачайте архив ру оп3-сраг4е-2.0.1.452 и распакуйте его в любую папку. 
Представим, что вы ее распаковали в папку С\Руфоп39. Далее откройте 
командую строку и введите команду: 


са С: \РуЕБоп39\руЕВоп3-срагае*-2.0.1 


После этого нужно запустить программу установки: 


са с: \РуЕВоп39\руЕВоп.ехе зебир.ру 1п3а11 
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После установки библиотеки ее можно использовать: 


>>> парогЕ свагаее 


Для определения кодировки используется функция 
Чесес®(<последовательность байтов>). В качестве результата функция 
возвращает словарь с элементами — епсо@тЕ и сопраепсе. Первый - это 
определенная кодировка, второй - вещественное число, задающее коэффи- 
циент точности определения кодировки. 


Пример: 


>>> парогЕ свагаее 
>>> спагаеф.4ефес+ (руфез ("Текст", "ср1251") ) 
{ 'сопНаепсе' :0.99, 'епсо41па': 'им1паомз-1251'} 


Как видите, мы передали функции строкубайтов вкодировке \УЛп4о\з-1251, 
и она правильно ее определила с точностью 99%. 


17.6. Реализация НТТР-клиента 


Представим, что есть сценарий ййр://пй.сешег/5спрёрйр. Ему нужно пере- 
дать параметры уаг1 и уаг2, а потом считать результат его работы. 


В простых случаях вполне достаточно будет модуля игШЬ.гедиезе. Напри- 
мер, для отправки простого запроса НТТР СЕТ удаленному сервису доста- 
точно сделать следующее: 


Егом 0.1115 1прог® геаиез®, рагзе 

# ОВЬ, к которому производится доступ 

иЕ1 = 'В6р://п16.серЕег/зск1ре.рЮр"' 

# Словарь с параметрами запроса (если есть) 


рагмз$ = { 
'Уаг1' : '\уа1ае!1', 
'уаг2' : 'уа1ае2' 


} 
# Кодируем строку запроса 
ацегузг1пд = рагзе.их1епсоае (рагтз) 
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# Производим СЕТ-запрос и читаем ответ 
и = геацезе.иг1ореп (11:1+'?' + алегузЕг1па) 
гезр = и.геаа\() 


Если вам нужно отправить параметры запроса в теле РОЗТ-запроса, снача- 
ла закодируйте их и отправьте в виде опционального аргумента игореп(): 


Егом их111р 1прог® геацез®, рагзе 

# ОВЬ, к которому производится доступ 

иг] = 'РЕёр://п1.сепеег/зск1ре.рЮр' 

# Словарь с параметрами запроса (если есть) 


рагмз$ = { 
'паме1' : 'уа1пе1', 
'паме2' : 'уа11ае2' 


} 
# Кодируем строку запроса 
апегузЕг1па = рагзе .иг1епсоае (рагпт$) 


# Производим РОЗТ-запрос и читаем ответ 
и = геачезе.икг1ореп (иг1, алегузЕг1па.епсоае ('а$с11')) 
гезр = а.геаа () 


Если вам нужно предоставить пользовательские НТТР-заголовки в исхо- 
дящем запросе, например, изменить поле Озег-Авеп+ (обычно используется 
для указания браузера), создайте словарь, содержащий их значения, соз- 
дайте экземпляр Кедиез6 и передайте его в и /ореп(). Например: 


Егом мх:111р 1прогЕ геааез®,. рагзе 


# Дополнительные заголовки 
реааег$ = { 
'Озег-ачепе' : 'Му РУуЕПоп Вгоизег! 
} 
геа = геалез*.Веацез* (и:1, апегузег1па.епсоае ('а$с11'), 
Беааегз=Веааегз) 
# Производим запрос и читаем ответ 
и = геачезе.иг1ореп (геа) 
гезр = а.геаа () 


ГЛАВА 18. 


ИТЕРАТОРЫ И 
ГЕНЕРАТОРЫ 


©. ру Глава 18. Итераторы и генераторы 


Итерация - одна из самых сильных функций РуПоп. На высоком уровне вы 
можете просто рассматривать итерацию как способ обработки элементов в 
последовательности. Однако вам доступно намного больше, например, соз- 
дание собственных объектов Негафог (итераторов), применение полезных 
итеративных образцов в модуле Шегбоо[$, создание функций-генераторов 
и т.д. Эта глава стремится лишь показать типичные задачи, вовлекаюпгие 
итерацию. 


18.1. Ручное использование 
итератора 


Начнем с самого простого примера: вам нужно обработать элементы в ите- 
рируемом, но по некоторым причинам вы не можете или не хотите исполь- 
зовать цикл г. 


Используйте функцию иех{() и напишите код для перехвата исключения 
„юрПетаноп. Например, этот пример читает все строки из файла: 


м1ЕВ ореп('сгоп.1о9') аз : 
&гу: 
мЬ11е Тгое: 
11пе = пех (Е) 
рг1п+ (11пе, епа='') 
ехсере ЗЕорТЕега®1оп: 
разз 
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Обычно исключение 5орПетайоп используется для уведомления об окон- 
чании итерации. Однако, если вы будете использовать иел() вручную (как 
и показано), вы можете также возвращать какое-то завершающееся значе- 
ние вроде №пте. Например: 


у1ЕВ ореп('сгоп.10о3') аз ЕЁ: 
ур11е Тгое: 
11пе = пех (Е, Мопе) 
1Е 11пе 13 М№опе: 
Ьгеак 


рг1пе(11пе, епа='') 


В большинстве случаев для перебора итерируемого используется оператор 
Гог. Однако время от времени задачи будут требовать более точного управ- 
ления итеративным механизмом. Таким образом, полезно знать, что факти- 
чески происходит. 


Следующий интерактивный пример иллюстрирует основную механику 
того, что происходит во время итерации: 


>>> 1%етз = [1, 2, 3] 

>>> # Получаем итератор 

>>> 1 = 1%ег (14етз) # Вызываем 1%ет5. _16екг_ () 
>>> # Запускаем итератор 

>>> пехе(1е) # Вызываем 1%. пехе () 


>>> пех (1+) 
>>> пех (1+) 


>>> пех (1+) 

ТгасерасК (моз гесеп® са11 1аз%): 
Е11е "<эз&а1п>", 11п0е 1, 11 <пмоао1е> 

ЗЕортТЕега®1оп 

>>> 


Последующие примеры в этой главе подробно останавливаются на итера- 
тивных методах и подразумевают, что вы знакомы с основным протоколом 
итератора. 
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18.2. Делегирование итерации 


Представим, что у нас есть пользовательский объект контейнера, который 
внутри содержит список, кортеж или какое-то другое итерируемое. Нужно 
проделать итерацию с вашим новым контейнером. 


Как правило, все, что вам нужно сделать - это определить метод __Цег()__, 
который делегирует итерацию к внутреннему контейнеру. Например: 


с1азз Моае: 
4еЕ 111% _(3е1Е, уа1ае): 
зе1Ё._уа1ще = уа]ае 
зе1Е._сВ11агеп = [] 


4еЕ __герг _ (зе1Е): 
гееихп 'Моде({!г})'.Еогша® (зе1Ё._уа1ще) 


4еЕ ааа сь11а(зе1#, поае): 
зе1._с511Агеп .аррепа (поде) 


4еЕ _ 1%ех__ (зе1Е): 
гееигп 14ег (зе1Е._сВ11@9геп) 


# Пример 

1Е _паше == '__ма1п _': 
гооЕ = Моае (0) 
сВ11а1 = Моае (1) 


гоое.ааа сь114(сь11а1) 
гооЕ.а4а сь114 (св1142) 
Бог св 1п гоое: 
рг1п® (св) 
# Выводит М№ае (1), М№ае (2) 


В этом коде метод __ Цег _() просто перенаправляет запрос итерации к 
внутреннему атрибуту _сВагеп. 


Протокол итератора в Ру оп требует __Цег _() для возврата специального 
объекта итератора, который реализует метод __пехё__() для выполнения 
фактической итерации. 


Если все, что вы делаете, это просто итерация по содержимому другого 
контейнера, вам не нужно волноваться о том, как это работает. Все, ЧТО ВЫ 
должны сделать, это перенаправить запрос итерации вперед. 
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Использование функции Цег() здесь что-то вроде ярлыка, который делает 
код чище. Функция просто возвращает базовый итератор, вызывая метод 
$. _Цег _(). 


18.3. Создание нового шаблона 
итерации с помощью генераторов 


В этом примере мы попытаемся реализовать пользовательский шаблон 
итерации, который отличается от обычных встроенных функций (напри- 
мер, тапде(), теоетзе4() и т.д.). 


Если вам нужно реализовать новый вид шаблона итерации, определите его 
как функцию-генератор. Здесь приведен генератор, который создает диа- 
пазон чисел с плавающей точкой: 


А4еЕ шу гапде (зваг®, зЕор, 1псгемепЕ): 
х = збагЕ 
мЬ11е х < з®ор: 
у1е1Аа х 
х += 1асгетеле 


Чтобы использовать эту функцию, вам нужно итерировать по ней в цикле 


фог или использовать ее с другой функцией, работающей с итерируемым 
(например, 5ит(), 150) и т.д.). Например: 


>>> Еог п 1п му гапде (0, 4, 0.5): 
. рк1п (п) 


шшьноо. 


>>> 1136 (ту гапде(0, 1, 0.125)) 
[О:. О. 25, 02.5, 0:37.5: «бб, 625, 0:75, :0.89.51] 
>>> 
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Простое присутствие оператора уе!4 в функции превращает ее в генератор. 
Вотличие от обычной функции, генератор работает только в ответ на итера- 
цию. Ради эксперимента рассмотрим, как работает такая функция: 


>>> АеЕ соипЕаомп (п): 

... Рхе1пЕ('Начальная позиция отсчета: ', п) 

... №МБ11е п > 0: 

ве узе1а п 

ев п -=>1 

... Рг1 п ( 'Готово! ') 

>>> # Создаем генератор, обратите, что не будет никакого 
вывода 

>>> с = соипЕЯдомп (3) 

>>> с 

<депегаеог оБ]есЕ соипЕЧомп аЕ 0х1006а0аЕ0> 

>>> # Запускаем генератор до первого у1е1А и получаем значение 
>>> пех (с) 

Начальная позиция отсчета 3 


>>> # Запуск до следующего у1е1а 
>>> пехЕ (с) 


>>> # Запуск до следующего у1е1а 
>>> пех (с) 


>>> #1 Запуск до следующего у1е1А (итерация останавливается) 
>>> пехЕ (с) 
Готово! 
ТгасебасКк (позе гесепЕ са11 1аз®): 
Е1]е "<зЕ4а1п>", 11те 1, 1п <поао1е> 
ЗЕортТЕега*1оп 
>>> 


Главная особенность -— то, что функция генератора только работает в ответ 
на "следующие" операции, выполненные в итерации. Как только функция 
возвращается, итерация останавливается. Однако обычно цикл юг забо- 
титься обо всех деталях, поэтому вас это не должно волновать. 
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18.4. Реализация протокола 
итератора 


При создании пользовательских объектов, поддерживающих итерацию, по- 
лезно реализовать и протокол итератора. 


Безусловно, самый простой способ реализовать итерацию на объекте за- 
ключается в использовании функции-генератора. 


Ранее был разработан класс Моде для представления структур деревьев. 
Возможно, вы хотите реализовать итератор, который делает обход узлов в 
глубину (метод будет называться аерёй_}752). Вот как это можно сделать 


с1азз Моае: 
деЁ __ 111% (з3е1Е, уа]1ме): 
зе1Е._уа1ме = уа1ое 
зе1Е._ср11Агеп = [] 


4еЕ __герг__ (зе1Е): 
гееигп 'Мо4е({!г})'.Еогша+* (зе1Ё. _уа1че) 


4еЕ ааа сь114(зе1Е, поае): 
зе1Е._св11Агеп .арреп4 (поде) 


4еЕ __1%ег__ (зе1ЕЁ): 
гееигп 14ег (зе1Е. _сВ11агеп) 


деЕ 4ерЕВ_Ягз{ (зе1Е): 
у1е14 зе1Е 
Еог с 11 зе1Е: 
у1е14 Егом с.дерЕВ Ягз*() 


# Пример 

1Е __паше__ == '__ маза _': 
гооф = Моае (0) 
св1191 = Моае (1) 
св11492 = Моае (2) 
гоое.а@4 ср11а(св1141) 
гоо*.а44 ср11а(св1142) 
сВ1191.а94_сь1194 (Моде (3) ) 
сВ1191.а94_св1194 (Моде (4)) 
ср1192.а94_св1194 (Моде (5)) 


Еог СВ 1п гоое.ЧереВ Ягз®(): 
ре1пЕё (св) 
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# Выведет Моае (0), Моде (1), М№оае(3), Моае (4), Моае (2), 
Моае (5) 


Метод 4ерй#_/15() прост. Сначала он выполняет оператор 1/4е/4 зе), а за- 


тем итерирует по каждому дочернему элементу, отправляя с помощью уе 4 
каждый дочерний элемент, произведенный методом 4ерй_/т5Е() дочернего 
элемента (используя уе тот). 


Протокол итератора Ру{оп требует метод __Кег__() для возврата специ- 
ального объекта итератора, который реализует операцию __пехё__()и 
использует исключение 5орПетайоп для уведомления о завершении ите- 
рации. Однако реализация таких объектов может часто быть "грязным" де- 
лом. Например, следующий код показывает альтернативную реализацию 
метода 4ерй_/7$Г(), используя связанный класс Цегавог: 


с1азз Моае: 
4еЕ __1п1Е__(3е1ЁЕ, уа]1ще): 
зе1Ё._уа1пе = уа1пе 
зе1._ср11Агеп = [] 


4еЕ __герг _ (зе1#): 
геЕагп 'Мо4е({!:})'.Еогша* (зе1#._уа]1ле) 


4еЕ ааа _сь114 (зе1#, оЕВег_по4е): 
зе1Е._с511Агеп .аррепа (оЕНег_поде) 


4еЕ __1%ег__ (зе1Е): 
геёикп 1%ехг (3е1#._ср11Агеп) 


4еЕ дерЕев_Вгз+ (зе1#) : 
геЕогп ОерЕВР1гзЕТфегафог (зе1Е) 


с1азз РерЕВЕР1гзЕТфегафог (оЪ)есе): 


ггг 


Обход в глубину 
ггг 
4еЕ __1п01Е__(3е1Е, зфаге_по4е): 
зе1Ё._по4е = зфагЕ поде 
зе1._ср11Агеп_1%ег = Мопе 
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зе1Е._ср114 1+ег = Мопе 


аеЕ __1%ег__ (зе1Е): 
гефогп зе1Е 


4еЕ __пех®__ (зе1Е): 
# Возвращает себя, если только запущен. Создает итератор для дочерних 


# объектов 
1Е зе1Е._сЬ11Чгеп_1%ег 13 Мопе: 
зе1Е._сВ11агеп_1%ег = 1%ег (зе1Ё. _поае) 


гееигп зе1Ё._поае 


# Если обрабатывается дочерний объект, возвращает его следующий элемент 
е11Е зе1Е._ср114 1+ег: 
$гу: 
пехЕср114 = пех (зе1Ё._сЬ11а 1%ег) 
геЕсгп пехёсЬ11а 
ехсерЕ ЗЕорТфега®1оп: 
зе1Е._сВ114_1%ег = Мопе 
геЕагп пехё(зе1Е) 
# Переход к следующему потомку и запуск его итерации 
е15е: 
зе1#._ср11А 1%ег = пехё (зе1Ё._сЬ11Агеп 1%ег).ЗереВ Вгз () 


гееагп пехё (зе1Е) 


Класс Дер йЕт$;Шетаг работает так же, как и версия с генератором, но это 
— путаница, потому что итератор должен обслуживать болыше сложного 
состояния о том, где он находится в процессе итерации. Откровенно гово- 
ря, никому не нравится писать такой взрывающий мозг код, как этот. Опре- 
делите свой итератор, как генератор и жизнь станет проще. 


18.5. Итерация в обратном 
направлении 


Для итерации в обратном направлении используйте встроенную функцию 
тецетзе(). Например: 
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>>> а = [1, 2, 3, 4] 
>>> Еог х 1п геуегзе@ (а): 
рг1пе (х) 


мою. 


Обратная итерация работает только, если объект имеет размер, который 
может быть определен или жеу объекта реализован специальный метод __ 
геуегзе4__(). Если для вашего объекта не выполняется ни то, ни другое, вам 
нужно сначала конвертировать ваш объект в список. Например: 
# Выводим файл в обратном порядке 
{ = ореп ('81е.+х*') 
Бог 11пе 1п геуегзеа (113%(#)): 

рг1п*(11пе, епа='') 


Знайте, что превращение итерируемого в список, как показано выше, может 
требовать огромного количества памяти, если итерируемое большое. 


Многие программисты не понимают, что обратная итерация может быть 
настроена с помощью определяемых пользователем классов, если они реа- 
лизуют метод __ геуегзе4__ (). Например: 


с1азз СоспЕаомп: 
4еЕ __111%__(3е1Е, зфаг®): 
зе1Ё.зфахг = зваге 


# Итератор вперед 
деЕ __1%ех__ (зе1=): 
п = зе1Е. зкаге 
мЬ11е п > 0: 
у1е14а п 
п -=1 
# Итератор назад 
4еЕ __геуегзеЯ _ (зе1Е): 
п=1 
мВ1]е п <= зе1 Е. зфагф: 
у1е1Аа п 
п +4=1 
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Определение обратного итератора делает код намного более эффективным, 
поскольку больше нет необходимости преобразовывать данные в список и 
итерировать по списку в обратном направлении, 


18.6. Экстра-состояние функции- 
генератора 


Если вы хотите, чтобы генератор представил дополнительное состояние 
пользователю, не забывайте, что вы можете легко реализовать его, как 
класс, поместим код функции-генератора в метод __Иег__(). Например: 


Его со11ес&1опз проге 4аесоае 


с1азз 11пер1зфоху: 
4еЕ __ 1101 (3зе1#, 11пез, В131еп=3): 
зе1Е.11пез = 11пез 
зе1Ё.В1з6огу = 4едоае (пах1еп=Б13%1еп) 


4еЕ __1+егх__ (зе1#): 
Еог 11пепо, 11пе 1п епомега+е (зе1{.11пез,1): 
зе1 Е .В1з6огу .аррепа ( (11пепо, 11пе)) 
у1е1а 11пе 


е{Е с1еахг (зе1{): 


зе1 Е.В 1з6огу.с1еахг () 


Чтобы использовать этот класс, смотрите на него как на обычную функ- 
цию-генератор. Однако, поскольку она создает экземпляр, вы можете полу- 
чить доступ к внутренним атрибутам, таким как атрибут №1$6огу или метод 
сеат(). Например: 


м1ЕВ ореп ('зотей1е.Ехе') аз ЕЁ: 
11пез = 11лер1зФогу (Е) 
Еог 11пе 1п 11пез: 
1Е 'руЕПоп' 1п 11те: 
Еог 11пепо, В11пе 1п 11пез.В1зеогу: 
рхг1п* ('{}:{}'.Еогтаф (11пепо, В11пе), 
епд='') 
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Используя генераторы, легко попасть в ловушку, попытавшись сделать все 
только функциями. Это может привести к очень сложному коду, особенно 
если функция-генератор должна взаимодействовать с другими частями 
вашей программы необычными способами (предоставлять атрибуты, раз- 
решать управление через вызов метода и т.д.). Если это так, просто исполь- 
зуйте определение класса, как показано выше. При определении генератора 
в методе _ Цег _() не нужно изменять свой алгоритм. Тот факт, что это 
часть класса упрощает доступ пользователей к атрибутам и методам, что- 
бы взаимодействовать с ними. 


Есть одна потенциальная тонкость с показанным методом - то, что он мог 
бы потребовать дополнительный шаг, заключающийся в вызове йет(), если 
вы собираетесь управлять итерация, используя технику, отличную от цикла 
Гог. Например: 


>>> Е = ореп ('Я1е.Ех*') 
>>> 11пез = 11пеНн1з*охгу (Е) 
>>> пех (11пез) 
ТгасерасКк (мозЕ гесепе са11 1аз®): 
Е11е "<56а1п>", 110е 1, 1п <моао1е» 
ТуреЕггог: '11пер156огу' оБ]есЕ 1$ поф ап 1%ега®ог 
>>> # Сначала вызываем 1%ег(), затем запускаем итерацию 
>>> 1& = 14ег (11пез) 
>>> пех (14) 
'11пе 1\п' 
>>> пех (1+) 
']11пе 2\п' 
>>> 


18.7. Пропуск первой части 
итерируемого 


Модуль &егбоо!$ содержит несколько функций, которые могут исполь- 


зоваться для решения этой задачи. Первой является функция йЙепооб. 
ФорийЦе(), которой нужно передать функцию и итерируемое. Возвращен- 
ный итератор отбрасывает первые элементы в последовательности, пока 
предоставленная функция не вернет #ие. 


Чтобы проиллюстрировать использование этой функции, представим, что у 
нас есть файл, который начинается серией комментариев. Например: 
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>>> м1ЕР ореп ('6езе.Ехе') аз ЕЁ: 
Бог 1]1пе ап Е: 
рг1п*(11пе, епа='') 


# Сомтмепе 110е 1 
# Сопмепе 110е 2 
Т1ре 1 

Т1пе 2 

Т1ре 3 

>>> 


Если вам нужно пропустить все начальные комментарии, вам нужно сде- 


лать это: 


>>> Егом 1%екеоо15$ ШирогЕ аАгормНВ11е 
>>> м1ЕР ореп ('6езе.Ехе') аз ЕЁ: 
ее Еог 11пе 1п агормиЬ11е (1апЪЧа 11пе: 11пе. 
зЕа’г+зм1В ('#'), Е): 
рг1п® (11пе, епа='') 
Т1пе 1 
ие 2 


Трое 3 
>>> 


Этот пример основан на пропуске первых элементов в соответствии с функ- 
цией (её. Если вы знаете точное число элементов, которые вы хотите про- 
пустить, вы можете использовать другую функцию -— йейооблейсе(). На- 
пример: 
>>> Егош 1%егеоо15$ ШирогЕ 1511се 
>>> 1%ещз = ['а', 'Ъ', 'с', 1, 4, 10, 15] 
>>> Еог х 1п 15$11се (1%етз, 3, Мопе): 

рг1п® (х) 


В этом примере последний аргумент №пе к 1$1се() требуется, чтобы ука- 


зать, что вы хотите получить все после первых трех элементов в противопо- 
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ложность только первым трем элементам (например, часть [3:] в в противо- 
положность части [:3]). 


18.8. Итерирование по всем 
возможным комбинациям или 
перестановкам 


Модель {еоо]$ предоставляет три функции для этой задачи. Первая из 


них — Иепоо[5.реттшаноп5() принимает коллекцию элементов и произво- 
дит последовательность кортежей, содержащую все возможные переста- 
новки элементов (то есть она перемешивает коллекцию во все возможные 
конфигурации). Например: 


>>> 14етз = ['а', 'Ь', 'с'] 

>>> Его 16егеоо]з 1троге регмафае1опз 
>>> Еог р 1п регшоафае1опз (14етз) : 

м рг1п® (р) 


та"; "БУ 5] 
('а', чат, 5) 
(5, аи» че". 
(5, Че 'а') 
ое 'а', 'Ъ') 
(=. 'Ъ', 8". 


12 1рЕ $ней 392 - о х 


Бе Еди Зе! Пебьд Орнопз Уйпаом Нер 
Руспоп 3.9.2 (1а45/У3.9.2:1а79785, Кер 19 2021, 13:44:55) [М3С у.1928 64 Б1Е {АМ ^ 
264}] оп мзп32 
Туре "Ве?р", "соруг1чве", "сгеа1е5" ог "11сепзе{)" ог тоге зоЕогщаефоп. 
>>> Зет = {'4', *р', '2'} 
>>> 22 16ег60015 ! $ региаба®1оп5 
>>> Ёрх р зп региабае1отз (16ет$): 
ВЕС (р) 


ам, пм 
Сас 
(5, ча, * 
Б*, ем * 
{'с', 'а', ' 
(с, 1", ' 
>>> 
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Если вы хотите получить все перестановки меньшей длины, вы можете за- 
дать необязательный параметр длины. Например: 


>>> Еог р 1п регшава®1опз (1%ещз, 2): 
ь рг1п® (р) 


Функция Йеооб.сот/таноп5() используется для создания последователь- 
ности комбинаций элементов, взятых при вводе. Например: 


>>> Егош 1%ег*оо1з проге сошЬ1пае1опз 

>>> Еог с 1п сотЬ1паЕ1опз (1%ещз, 3): 
.. релпе (с) 

(тах бо ь ие) 

>>> Еог с 1п сотЬ1па&1опз (1%етз, 2): 
... Рг1п (с) 


( т Ь т г. т 
>>> Еог с 1п сопЬ1па&1опз (1%етз, 1): 
... РГ1п® (с) 


Для сотытайоп5() не рассматривается актуальный порядок элементов. 
Поэтому комбинация (‘а’, Ъ") рассматривается как аналогичная ('Ъ', 'а'’) и 
не выводится. 


При создании комбинаций выбранные элементы удаляются из коллекции 
возможных кандидатов (то есть, если 'а' уже выбрана, то она больше не рас- 
сматривается). 
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Функция йепооб.сотьЬтаНноп$ _ший_тер[асетеп() позволяет одному и тому 
же элементу выбираться несколько раз. Например: 


>>> Еог с 1п сошр1пае1опз м1В гер1асетепЕ (1%ещз, 3): 


ар рг1п* (с) 
('а', `а”", 'а') 
а ма" 'р') 
('а', ‘аз; "с’.) 
(’а', '5', 'р') 
('а', 'Ъ' =") 
(зай: че”, =’) 
(“Б”, "Би 'Ь') 
(5%, 5, "©. ’) 
(5, с ©’) 
(ео, че", ©”) 


Этот пример демонстрирует только часть всей мощи, которую вы можете 
обнаружить в модуле Цегбоо[5. Несмотря на то, что вы можете, конечно, за- 
писать код, чтобы произвести перестановки сами, это потребует дополни- 
тельных затрат времени. Да и зачем изобретать колесо заново? Когда вы 
сталкиваетесь с итеративными задачами, в первую очередь обратитесь к 
модулю Негбоо]$. Если ваша задача распространенная, вполне возможно, 
что ее решение уже есть в #егбоо[5. 


ГЛАВА 19. 


ДОКУМЕНТИРОВАНИЕ 
ПРОЕКТА 
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Очень часто документированию проекта уделяется мало внимания или же 
вообще этим никто не занимается. Делается это по самым разным причи- 
нам, среди которых можно выделить нехватку времени, финансирования, 
отсутствие технических писателей в штате. Почему-то так повелось, что ни- 
кто не закладывает в проект время/финансы, необходимое на разработку 
документации - ни разработчик, ни заказчик. 


Заказчик часто не хочет тратить дополнительные средства в надежде, что 
в случае чего есть разработчик, который все поправит. Но в жизни все ме- 
няется — компании, которая разрабатывала проект, может уже и не быть на 
момент необходимости внесения изменений, отношения с этой компанией 
могут быть испорчены и т.д. Заказчик почему-то думает, что сторонним раз- 
работчикам будет просто разобраться в коде, который был написан кем-то 
другим. На практике бывает так, что даже самому разработчику несколько 
месяцев спустя сложно разобраться в собственном коде и нужно время, что- 
бы все вспомнить. Наличие документации позволит "вспомнить все" гораз- 
до быстрее, а также разобраться в коде сторонним разработчикам, если в 
этом возникнет необходимость. 
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19.1. Рекомендации относительно 
написания технической 
документации 


Поддерживать хорошую документацию довольно несложно, даже проще, 
чем писать код, хотя многие думают иначе. Документировать проект станет 
проще, если придерживаться некоторых рекомендаций относительно тех- 
нического письма. 


Если вы никогда раньше ничего не писали, не отчаивайтесь - ведь вам нуж- 
но написать не роман, а всего лишь описать, как работает ваши АРТ 
(Аррйсайоп Ргортатпипр [тщеггасе, АРТ — описание способов (набор клас- 
сов, процедур, функций, структур или констант), которыми одна компью- 
терная программа может взаимодействовать с другой программой). Грубо 
говоря, составить список функций, описать назначение каждой функции и 
назначение каждого передаваемого в функцию параметра. 


Вкратце рекомендации выглядят так: 


® Сформулируйте направления, а затем развивайте их. Первым делом 
опишите список того, о чем вы хотите написать, если хотите - оглавле- 
ние. Дальше уже подробно описывайте каждый из разделов. 


» Помните о читателе. При написании документации помните, что ее кто- 
то будет читать. Если вы пишите руководство по панели управления 
(Аазрфоата), тогда нужно ориентироваться на обычного пользователя и, 
возможно, некоторые моменты нужно описать подробнее. Если вы опи- 
сываете АРТ, тогда нужно ориентироваться на технического специали- 
ста. 


» Краткость - сестра таланта. Не нужно писать книту, а тем более книгу в 
нескольких томах. Пишите кратко и по делу. 


» Используйте шаблоны. Шаблоны помогают читателю привыкнуть к об- 
щей структуре документов. 


®е Используйте реальные примеры кода. Вместо того, чтобы фантазиро- 
вать и высказывать предположения, демонстрируйте реальные примеры 
кода и объясняйте, как он работает. 
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19.1.1. СФОРМУЛИРУЙТЕ НАПРАВЛЕНИЯ, А ЗАТЕМ 
РАЗВИВАЙТЕ ИХ 


Невозможно написать хороший текст за один проход. Не нужно пытаться 
придумать сразу же какой-то идеальный и всеобъемлющий текст. Вместо 
этого набросайте идеи, а затем развивайте их. Написав пару предложений, 
обязательно перечитайте их. Возможно, придется внести корректировки. 


План текста обязательно должен быть. В голове все удержать невозможно — 
кто-то позвонил, написал, вы отвлеклись и уже забыли, о чем думали. 


Есть и второй подход. Излагайте все идеи на бумаге, начинайте записывать 
непрерывный поток мыслей и не останавливайтесь, не обращайте внимания 
ни на стиль подачи, ни на грамматически ошибки /опечатки, просто пиши- 
те. Не останавливайтесь, пока не изложите все идеи. А уже после всего это 
займитесь структурированием текста, его улучшением и т.д. 


19.1.2. ПОМНИТЕ О ЧИТАТЕЛЕ 


При написании документа или его части вы должны понимать, кто будет 
вашей целевой аудиторией. Это очень важно. 


Не нужно стараться написать техническую документацию так, чтобы она 
была понятной даже школьнику. Так не должно быть. С техническим тек- 
стом все должно быть проще: он должен предназначаться определенному 
типу читателя. Придерживаясь этого правила, вы сэкономите кучу време- 
НИ. 


Если вы пишете документацию по АРТ, то ваш единственный тип читате- 
ля - программист. Ориентируйтесь на него. Если пишете документацию 
по панели управления - здесь вашим читателем будет обычный средне- 
статистический пользователь, об этом тоже нужно думать. Не нужно бес- 
покоиться о том, что этот текст может быть прочитан начальством со сто- 
роны заказчика. Ведь начальство — это такой же обычный пользователь, 
как и все остальные. 


Создайте два разных документа — один для пользователя (например, 
ЧазРЪБоаг4.ра#), второй — для разработчика (ар1.рЧ®. В каждом документе 
придерживайтесь собственного стиля подачи материала - так чтобы текст 
был понятен целевой аудитории. Понятно, что можно написать ар!.рЁ так, 
что он станет понятен даже пользователю, но зачем? Пользователь читать 
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его не будет, поскольку это не его обязанности, ау программиста лишь вы- 
зовет улыбку. Вы только потратите время, а лучше никому не сделаете. 


19.1.3. КРАТКОСТЬ — СЕСТРА ТАЛАНТА 


Упрощайте все по возможности. Простой текст воспринимается проще. Пи- 
шите простые и короткие предложения. Даже если вы не обладаете талан- 
том писателя, ваше творчество будет проще понять другим людям. Вы ведь 
пишите не роман и не сказку, а руководство по использованию АР[ вашего 
программного продукта. Не нужно, чтобы это руководство (без крайней на 
то необходимости) занимало объем в 1000 страниц. 


Придерживайтесь следующих рекомендаций: 


| 


Пишите короткие предложения. Максимальная длина предложения — 
150 символов с пробелами. В среднем в одной строке листа формата А4 
помещается 80-85 символов с пробелами. Так что старайтесь, чтобы ваше 
предложение не занимало более двух строк. 


Каждый абзац должен выражать свою идею и состоять из 3-4 предложе- 
ний. Не нужно писать абзацы, состоящие из более чем 10 предложений. 
10 предложений по 150 символов каждое — более чем достаточно для 
выражения законченной идеи. 


Не используйте разные формы времени, при написании технической до- 
кументации достаточно настоящего времени. 


Избегайте шуток, вы пишите не роман и даже не книгу по программиро- 
ванию. Вы просто пишите техническую документацию. Шутки и прочий 
юмор в ней смотрится глупо и неуместно. 


Не повторяйте одни и те же слова множество раз. Используйте аббреви- 
атуры. Например, вместо слова "программное обеспечение" пишите ПО. 
Как правило, в первый раз аббревиатура расшифровывается (ПО (про- 
граммное обеспечение) или программное обеспечение (далее - ПО)), 
далее используется без расшифровки. Можно также составить список 
используемых аббревиатур, если их слишком много. 


Плохая документация имеет одну отличительную черту - в ней невозмож- 
но найти нужную информацию, даже если она там есть. Продумайте струк- 
туру документа, разбивайте текст на разделы, используйте осмысленные 
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названия заголовков. Эти простые правила помогут создать понятный до- 
кумент, который будет просто читать. Если же всего этого вы не будете при- 
держиваться, читатели будут использовать средства поиска, чтобы найти 
нужную информацию. Но когда документация находится в распечатанном 
виде, сделать это будет очень проблематично. 


19.1.4. ИСПОЛЬЗУЙТЕ ШАБЛОНЫ 


В качестве примера использования шаблонов можно привести всем извест- 
ную "Википедию". Все страницы "Википедии" выглядят одинаково. Справа 
находятся блоки, обобщающие информацию из документов, которые при- 
надлежат к одной и той же области. Первая часть статьи обычно представ- 
ляет собой оглавление со ссылками, которые ведут на якоря в этом же тек- 
сте. А в конце странички всегда есть справочная информация. 


Шаблоны - штука полезная. Во-первых, к ним привыкают читатели. Они 
знают, что в каждом документе/разделе есть оглавление, позволяющее бы- 
стро найти нужную информацию. Также они знают, что внизу документа 
обязательно будет справочная информация со ссылками на полезные темы. 
Пользователи привыкают к общей структуре информации и учатся читать 
быстрее. 


Во-вторых, шаблоны полезны и для самого технического писателя — это 
быстрый старт для нового документа. Вам не нужно ничего выдумывать, вы 
просто используете уже готовый шаблон. 


19.1.5. ИСПОЛЬЗУЙТЕ РЕАЛЬНЫЕ ПРИМЕРЫ КОДА 


Помните, что вы пишите не учебник, объясняющий, как программировать 
на том языке, на котором написан ваш программный продукт, а техниче- 
скую документацию по программному продукту. Следовательно, нереали- 
стичные примеры кода усложняют понимание такой документации. 


Проще всего взять реальный фрагмент кода и пояснить все на нем. Рас- 
смотрим небольшой пример: 


#$ Получаем е-та11 пользователя из объекта изег 
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цета11 = изег.ета11; 


# запрашиваем количество доступных уроков из СВМ 
тезропзе = гечиезь$.де+ ("ВЕфр: //ехатр1е.сги/а1ЁЕа/а1Еа. 
рЬр?ета11=" + иема11 + "ё&ор=дее1еззопз") 


$ Текст ответа - это и есть количество доступных уроков 
1еззоп$ = гезропзе. Е ехе 

$ Получаем дату регистрации пользователя 
301п_Чафе = чзег.Чаее_)о1пеа 

$ Задаем граничную дату регистрации, начиная с этой даты 

# все зарегистрированные пользователи будут считаться новыми 
Бог4ег_Чафе = Чакец*11.рагзег.рагзе ('2021-09-23 

00:00:00+00:00') 


$ если граничная дата "старше" даты регистрации, то 
пользователь - старый 
# иначе - пользователь новый и переменную пеи_изег нужно 
установить в 1 
1Е Богаег Чабе > изег.Чаее )о1пеа: 
пем изег = 0 
е15е: 
пеи изег = 1 


# Флаг сокрытия курсов 
# Если пользователь новый и количество уроков = 0, то скрываем 
меню выбора курса 
р1ае_сопгзез = 0 
1Е пеи_ изег == 1 апа 1ез5опз == "0"; 
р14е_сопг5ез = 1 


Мы только что не просто привели фрагмент кода, но и в комментариях под- 
робно объяснили, для чего он используется. 


19.2. Строки документации в Ру{Поп 


Лучший способ поддерживать документацию в актуальном состоянии — 
относиться к ней, как к коду. Храните в репозитарии, отслеживайте вноси- 
мые изменения - так легко поддерживать актуальность документации. 
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Используя систему управления версиями (тот же СЁ), вы с легкостью 
сможете отследить все изменения, внесенные в документацию - не только 
вами, но и другими членами команды. 


Существуют инструменты, позволяющие создавать документацию АРГ 
прямо из комментариев, которые включены в исходный код. Это считает- 
ся лучшим способом создания технической документации для библиотеки 
или любого другого компонента, подразумевающего многократное исполь- 
зование кода. 


Что касается Руоп, то у него есть уникальные качества, облегчающие про- 
цесс документирования. Вы можете создавать красивую и полезную доку- 
ментацию прямо из кода Рупоп. Основной для этих инструментов служат 
строки документации (40с$71=5). 


Строки документации представляют собой специальные строковые лите- 
ралы Руфоп, предназначенные для документирования функций, методов, 
классов и моделей РуШфоп. Если первое определение функции, метода, 
класса или модуля является строковым литералом, то он автоматически 
станет строкой документации и превратится в значение атрибута __4ос__ 
для этой функции, метода, класса или модуля. 


Строки документации должны иметь все модули, все функции и классы, 
экспортируемые модулем. Также должны иметь строки документации пу- 
бличные методы (в том числе __шй__). 

Для описания строк документации всегда используются три двойных ка- 


вычки. Например: """строка документации""". Существует две формы строк 
документации: однострочная и многострочная. 


Однострочные строки документации должны помещаться на одной строке, 
и использоваться для очевидных случаев: 


АеЕ дек пзег_1пЕо ():; 


ШО НИ 


Возвращает массив с информацией о пользователе 
91оБа1 _изег 
1Е азег: гебогп _изег 


Используйте тройные кавычки, даже если документация умещается на од- 
ной строке. Закрывающие кавычки размещайте на той же строке. Это 
смотрится лучше. 


Многострочные строки документации состоят из однострочной строки до- 
кументации с последующей пустой строкой, а затем более подробным опи- 
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санием. Первая строка может быть использована автоматическими сред- 
ствами индексации, поэтому важно, чтобы она находилась на одной строке, 
и была отделена от остальной документации пустой строкой. Первая строка 
может быть на той же строке, где и открывающие кавычки, или на следую- 
щей строке. Вся документация должна иметь такой же отступ, как кавычки 
на первой строке. Рассмотрим пример: 


аеЁ зам (а=0.0, Ъ=0.0): 


"""Вычисляет сумму двух чисел 


Аргументы 
а - первое число (по умолчанию 0.0) 
Ь - второе число (по умолчанию 0.0) 


гебагп а+Ь 


19.3. Языки разметки для 
документации 


Внутри строк документации можно писать все, что угодно. Но желательно 
использовать какой-то язык разметки для документации, что поможет вам в 
дальнейшем. Неплохими вариантами являются языки разметки Магк4о\п 
и АзсИОос. Первый очень популярен в сообществе СИНиь и является наи- 
более распространенным языком разметки. Также он поддерживается раз- 
личными инструментами для самодокументирующихся АР]. 


Вообще, вы можете выбрать любой язык разметки, на котором вам легко 
писать и какой удобно читать в сыром виде за пределами сгенерирован- 
ной документации. Неплохим вариантом также является язык разметки 
геЗгистиге4 Техф, который используется системой документации ЗрЫпх. 


19.4. Популярные генераторы 
документации 


Наиболее популярными инструментами для создания документации в со- 
обществе Ру оп являются Зрышх и МКЕОок$. Сначала мы рассмотрим 
ЗрЫпх, а затем —- МКОосз. 
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19.4.1. ИСПОЛЬЗОВАНИЕ ЗРНМХ 


ЗрЫпх (англ. 5ОГ Ригазе таех) — система полнотекстового поиска, отличи- 
тельной особенностью которого является высокая скорость индексации и 
поиска, а такжеинтеграция с существующими СУБД (Му5ОГ, Роз{етеЗ ОГ.) 
и АРГ для распространенных языков веб-программирования. 


Для установки ЗрЫшх введите команду: 


р1р 1п$6а11 зрЬ1пх 


Примечание. Если команда рр недоступна, ее установить мож- 
но следующей командой зидо ар т\а! руПоп3-рр 


В ОБиша его можно также установить командой: 


зиао ар®е-дее 1п5$$а11 руЕВоп3-зрЬ1пх 


Использовать инструмент не очень сложно. Первым делом, нужно создать 
каталог для нового проекта и перейти в него: 


шка1г рг) 
са рг) 


Для инициализации проекта необходимо выполнить команду 5ртх-дшсР- 
ат 


5рЮ1пх-ап1скзваг® 


Программа задаст ряд вопросов. Все настройки можно будет позже изме- 
нить в файле сопёру. 


> Корневой каталог документации. По умолчанию текущий каталог. 
> ВооЕ раЕП Гог ЕВе аосимепеае1опт [.]: 


> Сделать ли раздельные папки исх. кода и готовых страниц - Да 
> Зерагаее зоигсе апа 5и11а а91гесеог1ез (у/м) [п]: у 


Рупоп. Полное руководство Анне 3; руепоп 


> Префикс для директорий с шаблонами и статическими файлами. 
> Маме ргейх Еог %етр1аЕез ап $з%ка®1с а1г [_]: 


> Название проекта. Для начала лучше вводить на латинице. 
> Ргодесе папе: 


> Имя автора/авторов. Для начала лучше вводить на латинице. 
> АОЕПОг папе (3) : 


> Версия проекта 
> Ргодесе уегз1оп: 


> Номер релиза проекта 
> Ркго)есе ге1еазе [1]: 


> Расширение исходного файла. По умолчанию .гз®. 
> боигсе ЁН1е зайх [.г3®]: 


> Имя мастер-документа. По умолчанию 1паех.гз®. 
> Маме оЕЁ уопцг маз®ег ЧоситепЕ (м1ЕРопЕ зийх) [1паех]: 


> Генерировать еРаЬ версию документации? 
> Ро уой мапе Фо изе ЕВе ерчь Би11аег (у/п) [п]: 


> Автоматически вставлять Ч4осз®хг1п9$ из модулей 
> аиеодос: ацота*1са11у 1п5ехЕ аосзЕх1паз ЁЕгом шоЧи1ез (у/п) [п]: 


> 
> аосЕезе: апота*1са11у фезе сое зп1рреёз 1п Чосеезе Ь1осКз$ (у/п) 
[2]: 


> 
> 1пеегзрЬ1пх: пк Беёмееп 5$рЬ1пх ЧаоситепеаЕ1оп оЁ Я1НегепЕ 
ргодесез (у/п) [п]: 


> 
> Еоао: иг1Ее "Ео4о" епЕг1ез Ва сап Бе зБомп ог Б1Ааеп оп БЮо11а 
(у/п) [п]: 


> 
> соуегаде: свеск$ Ёог Чаоситепеа1оп соуегаде (у/п) [п]: 


> Использовать модуль рпата®В для вставки формул в формате рпач 
рпачша®В: 1пс1а4е пар, геп4егеЯ аз РМС 1тадез (у/п) [п]: 


У 


> Использовать модуль паЕБ)ах для вставки формул в формате Ма®ВЗах 
> мае В)ах: 1пс1аае маеВ, гепаегеая 1п Бе Ьгомзег ру МаеВУТах (у/п) 


[п]: у 
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> 1ЕсопНа: сопа11опа1 1пс1а$1оп оЁ сопёепЕ разеа оп сопНд уа1лез 
(у/п) [п]: 


> 
> у1емсоае: 1пс1а4ае 11пКз о Епе зоцгсе сое оЁ досптепеейя РуЕроп 
ор)есЕз (у/п) [п]: 


> Создать МакеН1е - да 
> Сгеафе МаКеНн1е? (у/п) [у]: 


> Сделать ли файл „БаЕ, - нет, если у вас 11пах 
> Сгеафе М1паомз соптапа Н1е? (У/п) [у]: п () 


После ответа на вопросы будут созданы файлы ш4ех.гз&, сопёру, МаКейе, 
_ЪБиНа, айс, етр]афез: 


® Макее — содержит инструкции для генерации результирующего доку- 
мента командой таке. 


» _ри!а- директория, в которую будут помещены файлы в определенном 
формате после того, как будет запущен процесс их генерации. 


® _ (ас — в эту директорию помещаются все файлы, не являющиеся ис- 
ходным кодом (например, изображения). Позже создаются связи этих 
файлов с директорией Би!П4. 


® сопЁру — содержит конфигурационные параметры ЗрЫпх, включая те, 
которые были выбраны при запуске зрЫпх-дшсКзбаг( в окне терминала. 


® Шех.гзЕ — это корень проекта. Он соединяет документацию воедино, 
если она разделена на несколько файлов. 


Файл шдех.т$ используется для объединения всех файлов в один проект. 
По сути, это простой текстовый файл. Если открыть его, то можно будет 
увидеть примерно следующее: 


3 аоспмепеЕае1оп мазфег Н1е, сгеафеа Бу 
5рВ1пх-а11сКзбагЕ оп Ег1 бер 24 19:44:30 2021. 
Уои сап адарЕ 115 П1е сомр1еее1у Во уоцг 11К1п9, рае 1% 
5Во\й1А а 1еазЕ 
сопЕа1п Ее гооЕ `фосегее` а1гесе1уе. 


РУпоп. Полное руководство МООИ 2. ру+Поп 


Ме1соме $о 3'3з аосомеп*а*1оп! 


СопЕепёз: 


фосЕгее: : 
:пахаереВ: 2 


Тпа1сез апа фаб1ез 


: хеЕ: `деп1паех` 
: геЁ: `поа1паех` 
: геЁ: `зеагсВ` 


Содержимое ш4ех.гзё не должно включать много информации и в нем обя- 
зательно должна присутствовать директива .. {осёгее::. Чтобы включить 
в проект другие файлы, необходимо прописать названия этих файлов в .. 
босфгее::. Пример: 


Сосскеет: 
:пахаереВ: 2 


ехапр1е1 
ехапр1е2 


Здесь мы включили в проект два файла — ехатр/е1 .г5ё и ехатр]е2.г5(. Обра- 
тите внимание, что название файла пишется без расширения. Также важен 
отступ и пустая строка. 


Для генерации документации в НТМТ. формат необходимо выполнить в 
командной строке команду таЁе т. Аналогичным образом можно выпол- 
нить генерацию в другие форматы, например, таЁе ериб. 


са рг) 
паке ВЕп1 


Произойдет сборка НТМТ, выходные файлы будут помещены в директо- 
рию _БаЙ4/БетИ. Перейдите в нее и откройте файл т4ех.Б и в браузере. 
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Получив совсем немного исходных данных, ЗрЫшх сумел создать нечто 
большее. Вы получите несложную компоновку, содержащую информацию 
(9) документации проекта, раздел поиска, содержание, заметки об авторских 
правах, включая имя и дату, а также нумерацию страниц. И все это сделано 
автоматически! 


19.4.2. ИСПОЛЬЗОВАНИЕ МКООС$ 


Оба генератора документации, и Зр№шх, и МЕОосз написаны на Руоп. 
Эрих известен тем, что именно на нем сгенерирована документация для 
языка Ру оп. МЕГОос$ — это бесплатный статический генератор сайтов, 
предназначенный для создания проектной документации. Его можно ис- 
пользовать для создания автономного сайта с документацией по программ- 
ному продукту. 

Так как МЕОос$з создает статические файлы, ваша документация является 
легкой и простой в размещении — с использованием бесплатных сервисов, 
таких как СИНаЬ Рарез и Веаа Те Оосз, — или, конечно, на вашем соб- 
ственном сервере. Все, что вам нужно — это просто скопировать получив- 
шиеся файлы в каталог на веб-сервере. 


Для установки инструмента введите команду: 


Р1р 1п$$а11 шКаосз 


® Рис. 19.1. Установка тКдос$ 


РУНоп. Полное рукводстто №9 #2. рутпоп 


В ОБипеи шЕ4ос$ можно установить командой: 


зао арЕ 1п${а11 шКаосз$ 


После этого нужно создать НОВЫЙ проект и перейти в его каталог: 


са - 
пКаос5$ пем рг) 
са рЕ) 


Вывод второй команды будет таким: 


ТМРО - Сгеа®1пд ргодесЕ Ч1гесфоку: ркг) 
ТМРО - Мк1Е1ра сопНа В1е: рг)/пКаос$ .уп1 
ТМЕО - Мк1Е1па 11011а1 9осз: рЕ)/аосз/1п4ех.па 


После этого в каталоге ри} будут созданы следующие элементы: 
®» файл конфигурации шК4ос$.ут 


® одна страница документации 40с5/ш4ех.ли Ч 


Далее запустим 4еу-сервер для просмотра вашей документации. Убедитесь, 
что вы находитесь в том же каталоге, что и файл шК4ос$.уш|, и введите сле- 


дующую команду: 


|. 
& 


рама 


Рис. 19.2. Запуск веб-сервера Ф 
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$ шКаосз зекуе 

ТМЕО — Ви1141пд ЧАосимепеа®1от... 

ТМЕО - С1еап1пд з1%е а1гесфогу 

[Т 270921 03:50:43 зегкуег:271] 5егу1па оп 
ВЕЕр://127.0.0.1:8000 

[Т 270921 03:50:43 Вапа1ег$:58] Зак маесЬ1пау сВапаез 
[Т 270921 03:50:43 Вапа1ег$:60] ЗЕагЕ аебесе1па свапдез 


Откройте браузер и введите ОВГ. ййр://127.0.0.1:8000. Вы увидите сгенери- 
рованный шаблон для вашей будущей документации. 


Начало положено. Далее нужно открыть тК4осз.ут] и указать название ва- 
шего проекта и адрес сайта проекта: 

31$е паме: МуРг) 

31$е игк1: ПЕфрз: //ехамр1е .сом/ 


Перезагрузите страничку в браузере, и вы сразу же увидите изменения — 
вместо МКОос$з будет отображаться название вашего проекта (МуР!т)). 


диз 


° инынюное = \Месоте {о МКОос$ 


> орла аонпелают ‘ий 14105.79 


' Соттапа$ 


* 54б0Сз пен {045 -сате) . Слез а пех рлзесь 

* якассь зесче < щи фе пиелеабоу соку эенче. 
* дос №4 - ВЫ Ве бовителхансв хе. 

* вибосз Л - Рае ннезбобе ап экй, 


раша 


5 Ргоесауош 
7 Зыдос,уы < 


чьи 
Чбеалоеб в а илнии дак лев 
Е И 


бовкзтиатламит Бои АО 


Рис. 19.3. Сгенерированная документация 


Рупоп. Полное руководство ры. ООО (= ру{поп 


Настало время добавить в наш проект дополнительные страницы. Для это- 
го в шК4осз.ут| нужно добавить секцию паи: 


пах: 
— Номе: 1зпаех.па 
- АроцЕ: аБойе.ма 


Страничка т4ех.т4 уже создана, а вот страничка 4ос$/аБбо.т4 отсутству- 
ет. Создадим ее так: 


сиг1 'БЕЕрз://)азрегуа) .ре/1огет-магкаомпим/тагкаомчт.ехе' > 
Чаосз/аБоде .ма 


Для изменения темы оформления документации используется параметр 
фете в файле конфигурации: 


316е паме: МуРг) 
$16е их1: ВЕ&рз: //ехашр1е .сом/ 
пах: 
— Номе: 1паех.па 
- АБойе: аБоп*е.ма 
ЕВеме: геааеБедос$ 


В данном случае мы выбрали тему оформления геа4едосз. Получить до- 
полнительные темы можно на сайте: 


йрз/ Латяас®йетез.ео/555/тЁа4ос$/ 


После того, как вы добавили дополнительные страницы, изменили параме- 
тры проекта и выбрали новую тему оформления, нужно изменить /асоп 
вашего проекта. Для этого внутри каталога 40с$ создайте каталог ип8 и до- 
бавьте в него файл а\1соп.1со. МК4ос$ автоматически будет использовать 
этот файл в качестве /а%соп. 


Когда результат в браузере по адресу 127.0.0.1:8000 вас будет устраивать, 
настанет время для сборки сайта с документацией. Перейдите в каталог ри 
и введите команду: 


икаосз Ри11а 
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Внутри каталога проекта будет создан подкаталог Це, в котором будет на- 
ходиться НТМГ-версия вашей документации. Содержимое этого каталога 
можно опубликовать в Интернете, или поставлять вместе с вашим 
программным продуктом. 


Нужно отметить, что представленные генераторы документации, которые 
хоть и рассмотрены в контексте Руфоп, можно использовать для создания 
документации по любому программному продукту, независимо от языка 
программирования, на котором он написан. 


№5 /юшитосз.07т5/вете-яапеа/ 


ГЛАВА 20. 


МЕТА- 
ПРОГРАММИРОВАНИЕ 


2. ру. Глава 20. Метапрограммирование 


Метаклассы — это магия, о которой 99% пользователей не стоит 
даже задумываться. Если вам интересно, нужны ли они вам — тогда 
точно нет. Люди, которым они на самом деле нужны, знают, зачем, и 
что с ними делать. 


- Гуру Руфоп Тит Реетз 


20.1. Введение в 
метапрограммирование 


Метапрограммирование -— подход к написанию программ, которые можно 
обрабатывать как данные, что позволяет им просматривать, создавать/из- 
менять себя во время работы. Другими словами, мы можем написать про- 
грамму, которая будет изменять сама себя. 


В основном, метаклассы используются для создания АР 1. Типичным при- 
мером является Б]апбо ОВМ. Можно написать что-то вроде этого: 


с1аз5 Регзоп (тоде1$.Моае1) : 
паме = мо4ае1$.СПагЕ1е1А (пах _1епа®Н=30) 
аче = тпоае1$.ТпЕедегЕ1е1а () 


Ру{поп. Полное руководство ООО [= ру+поп 


Но если написать так: 


и5ег = Регзоп (паше='Ааеп', аде='38') 
рг1пё (а5ег.аде) 


Он не вернет объект ПицезегЕ1е!4. Он вернет код #ё и даже может взять его 
непосредственно из базы данных. 


Существует два основных подхода к метапрограммированию: 


» Первый концентрируется на возможности языка анализировать соб- 
ственные элементы -— функции, классы, типы, а также на возможности 
создавать или изменять их динамически, то есть в процессе выполнения 
программы. В Ру!фоп есть множество инструментов для этого. Эти ин- 
струменты используются различными ШЕ для анализа кода в режиме 
реального времени. Также существуют специальные методы классов, по- 
зволяющие вмешиваться в процедуру создания экземпляра класса - ме- 
таклассы. Благодаря метаклассам программист может полностью пере- 
делать реализацию ООП в Ру®оп. 


» Второй подход заключается в возможности программиста работать не- 
посредственно с кодом — как в простом виде (обычный текст), так и в 
форме абстрактного синтаксического дерева (АЗТ, АБзёгасЕ Зущах, 
'Тгее). Такой подход более сложный в реализации, зато дает возможность 
делать очень сложные и эффектные штуки, такие как расширение син- 
таксиса самого Руфоп или даже создание собственного языка програм- 
мирования. 


Далее мы рассмотрим декораторы в контексте метапрограммирования. 


20.2. Декораторы 


Декораторы — это синтаксический сахар, работающий по простой схеме: 


АеЕ Чесогафеа Еапс®1о1п(): 
разз 
Чесогафеа Рипс&1оп = зоме_Чесогафког (Чесогафеа Еипсе1оп) 


Данная форма показывает, что именно делает декоратор: он принимает объ- 
ект функции и изменяет его во время выполнения. Другими словами, новая 
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функция создается на основе предыдущей версии функции с тем же име- 
нем. Такое декорирование может быть очень сложной операцией, которая 
выполняет некоторый самоанализ кода (а не такой простой случай, как мы 
рассмотрели). Однако, все это позволяет использовать декораторы в каче- 
стве инструмента метапрограммирования. 


Основные принципы декораторов довольно просты, и это очень хорошо, по- 
скольку остальные способы метапрограммирования в Руоп гораздо слож- 
нее и приводят к существенному усложнению кода. 


В Рушфоп программист может использовать декораторы класса. По синтак- 
сису и реализации они аналогичны декораторам функций. 


Декоратор класса призван модифицировать поведение и содержание клас- 
са, не изменяя его исходный код. Похоже на наследование, но есть отличия: 


1. Декоратор класса имеет более глубокие возможности по влиянию на 
класс, он может удалять, добавлять, менять, переименовывать атрибуты 
и методы класса. Он может возвращать совершенно другой класс. 


2. Старый класс "затирается" и не может быть использован, как базовый - 
класс при полиморфизме 


3. Декорировать можно любой класс одним и тем же универсальным де- 
коратором, а при наследовании — мы ограничены иерархией классов и 
должны считаться с интерфейсами базовых классов. 


4. Презираются все принципы и ограничения ООП (из-за пунктов 1-3). 


Декораторы классов полезны, чтобы внедриться в класс и массово воздей- 
ствовать на его методы и атрибуты. Далее мы создадим декоратор, который 
будет измерять время выполнения каждого метода класса. При этом сам 
класс никаких изменений не претерпит, и не будет знать, что за ним следят: 


Листинг 20.1. Декоратор класса 


1проге Е1те 


# это вспомогательный декоратор будет декорировать каждый 
метод класса, 
# см. далее 
аеЕ +1ме1+{ (меЕпочд) : 
АеЕ +1меа(*агаз, **Км): 
{5 = Е1ще. 6 1те () 
гези1Е = меерпоа(*ага$, **Км) 
фе = &1тме.Е1те () 
ае1{$а = (+е - +3) * 1000 
рг1пё (Е' {пмебпоа. _паме } выполнялся {4е1%а:2.2Е} т5') 


РУНоп. Полное руководство ООО [= ру Поп 


гееигп гези1+е 
гебагп Е1теа 


АеЕ +Е1ме1Е а11 меерод$ (с1$): 
с1аз5 М№С15$: 


аеЕ 


аеЕ 


__ 11016  (5е1Ё, *агаз, **Киагаз): 


# проксируем полностью создание класса 
# создаем декорируемый класс 
зе1Ё. об) = с1$(*агдз, **Кмагаз) 


__ дефаеек1риее _ (5е1Е, $): 
Ее 
$ есть ли атрибут 3? 
х = зирег(). _ дебаЕЕг1риее (5) 
ехсерЕ АЕЕг1риееЕггог: 
# такого атрибута нет 
ра$$ 
е15е: 
$ такой атрибут есть 
гееагп х 


$ если объект, значит, должен быть атрибут 5 
аеег = зе1Е. ор). дефакег1Баее_ (5) 


# метод ли он? 
1Е 1з1п5$апсе (а г, Куре (5е1Е. _1п18__)): 
# да, обернуть его в измеритель времени 
гебагп &1те1+ (а ег) 
е1зе: 
$ не метод, что-то другое 
гебиги абег 


гееигп М№емС1$ 


@Е1те а11 с1аз5_ меЕво@Яз 


с1азз РГоо: 


еЕ а(зе1Е): 
рг1пе ("метод а начинает работу") 
ф1ще.з1еер (0.888) 
рг1пе ("метод а завершает работу") 


Е = Гоо() 
Е.а() 
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Вывод будет таким: 


# метод а начинает работу 
# метод а завершает работу 
$ а 889.84 мз 


Разберемся, что и кчему. Наш измеритель времени, йтей — простой декора- 
тор для функций. Он нам нужен, чтобы декоратор класса йтей_аП те йо 
обернул в тей каждый метод декорируемого класса. 


Декоратор Нтей_аЙ тео содержит в себе определение нового класса 
Ме\СЁ и возвращает его вместо оригинального класса. Другими словами, 
класс Роо — это уже не Роо, а МехС|5. Конструктор класса Ме\С!5 принима- 
ет произвольные аргументы (ведь нам не известно заранее, какой конструк- 
тор у Еоо, и у любого другого класса, который мы декорируем). Поэтому 
конструктор просто создает поле, где будет хранить экземпляр оригиналь- 
ного класса, и передает ему в конструктор все свои аргументы. 


Метод _вааитЬще_ вызывается, когда что-то пытается обратиться к 
какому-то атрибуту (полю, методу) класса Ме\С5. Мы должны обратиться 
к родителю 5ирех() и спросить у него, не обладаем ли мы сами атрибутом, 
который проверяем. Нужно обращаться именно к родителю, чтобы избе- 
жать рекурсии. Если это наш атрибут (атрибут класса декоратора) - вер- 
нем его сразу, с ним ничего не надо делать. В противном случае - если это 
атрибут исходного класса — нужно запросить его у него. Далее нужно прове- 
рить его тип, сравним его с типом любого метода. Если тип — метод (Боипа 
те йоа), то обернем его в декоратор йтей и вернем, иначе (это не метод, а 
свойство или статический метод) — вернем без изменений. 


В декораторах классов также доступны замыкания и параметризация. 
Пользуясь данными фактами, предыдущий пример можно переписать, сде- 
лав более читабельным и удобным в сопровождении: 


ЧеЕ рагамеег12е4_зПог®_ ше (тах_м1АЕН=8) : 
"""Параметризованный декоратор, сокращающий представление""" 
ЧеЕ рагамефг12еа (с1$): 
"""Внутренняя функция-оболочка, которая по сути является 
декоратором""" 
с1аз5$ 5ЗпогЕ1уВергезепееа (с15): 
"""Подкласс, представляющий поведение декоратора""" 
ЧеЕ _пЕа_ (зе1Е): 
гебагп зирег(). па _()[:тах мтаеп] 


Рупоп. Полное руководство 


гебакп брогЕ1уВергезепееа 


гебагп рагамефг12еа 


Главный недостаток использования замыканий в декораторах классов в 
том, что полученные объекты являются не экземплярами класса, который 
был задекорирован, а экземплярами подкласса, созданного динамически в 
функции декоратора. Среди прочего, это повлияет на атрибуты __пате__ 
й. а 


@рагамеег12еа_ зНоге шка (10) 
С1аз5$ С1а$$1+р11+Е1еВ1ЕГопаегЬопаМаме : 
раз5 


Такое использование декораторов класса приведет к следующим изменени- 
ям в метаданных класса: 


>>> С1а55И1{011Е1еВ1ЕТопдегЪопаМапе ().__с1а$$___ 
<с1аз5 '5погЕ1уВергезепееа'> 
>>> С1а55И141011%1еВ1&ТопдегТопаМаме ().__@9ос__ 


'Подкласс, представляющий поведение декоратора' 


20.3. Метаклассы 


20.3.1. ВВЕДЕНИЕ В МЕТАКЛАССЫ 


Метаклассы - одна из самых трудных концепций в РУФоп, поэтому многие 
программисты избегают ее использования. Давайте разберемся, что такое 
метакласс и как его можно использовать для метапрограммирования. 


Метакласс — это тип (класс), который определяет другие типы (классы). 
Грубо говоря, это "фича", создающая новые классы. Классы, определяющие 
экземпляры объектов, также являются объектами. А поэтому у них есть со- 
ответствующий класс. Основным типом каждого класса по умолчанию яв- 
ляется встроенный класс буре. 


Рассмотрим общий синтаксис метаклассов. Мы можем использовать вызов 
встроенного класса &уре() в качестве динамического объявления класса. 
Например, мы можем определить класс вызовом &/ре(): 
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аеЕ мефпоа (зе1Ё) : 
гесагп 1 


МуС15$ = буре ('МуС15', (об}есе,), {'меЕроа': шефВо4}) 


Все это’ эквивалентно обычному определению класса ключевым словом 
С1а$5: 


с1аз5 МуС15$: 
аеЕ мефпоа (зе1Е) : 
гесагп 1 


У каждого класса, создаваемого таким образом, есть метакласс фуре. Такое 
поведение по умолчанию можно изменить, если добавить именованный ар- 
гумент тебас!а$$: 


с1аз5 С1Мефа (мефас1азз=6уре) : 
разз 


Здесь значение, предоставляемое в качестве атрибута тебас!аз$, — еще один 
объект класса, но может быть любым другим вызываемым объектом, кото- 
рый принимает те же аргументы, что и класс фуре и возвращает другой объ- 
ект класса. 


Рассмотрим аргументы фуре: 
® пате - имя класса, которое будет храниться в атрибуте __ пате__; 


® [0565 — список родительских классов, которые станут атрибутом __ 
Базе _; 


® (СЕ - словарь, который будет являться пространством имен для тела 
класса (становится атрибутом '_ 41 _'). 


Почему имя вуре() пишется со строчной буквы? Скорее всего, это вопрос 
соответствия со 5 — классом, который отвечает за создание строк, и 17 — 
классом, создающим целочисленные объекты. фуре - это просто класс, соз- 
дающий объекты класса. Проверить можно с помощью атрибута __ с1аз$__. 
Все, что вы видите в Руфоп — объекты. В том числе и строки, числа, классы 
и функции. Все это объекты, и все они были созданы из класса: 


РУпоп. Полное руководсто ООО ©. руепоп 


>>> паше = 'аеп' 

>>> папе. _с1аз$ ___ 
<Еуре '5%г'> 

>>> аде = 38 

>>> аде. _с1аз$__ 
<Еуре '1пе'> 

>>> аеЕ Еоо(): раз$ 
>>> Еоо.__с1аз5__ 
<суре 'ЕопсЕ1оп'!> 

>>> с1аз5 С1$ (оБ]ес®): ра$$ 
>>> с = с15() 

>>> с. _с1а55__ 

<с1аз5 '_ ма1п__.С15'> 


А теперь самое интересное - что в атрибуте __с1аз$__ у самого __‹с1а$з__? 


>>> паше. _с1азз__. _с1аз55__ 
<руре 'Еуре'> 

>>> аде. _с1аз5з _. _с1а55 _ 
<фуре 'куре'> 

>>> Еоо. _с1аз55 _. _с1а55__ 
<руре '+уре'> 

>>> Сс.__с1азз__‚„__с1аз5__ 


<Еуре 'фуре'> 


Итак, метакласс создает объекты класса. Это можно назвать "фабрикой 
классов". буре — встроенный метакласс, который использует Ру оп. 
Программист может также создать свой собственный метакласс. 


Вернемся к атрибуту __тебас]азз__. При определении класса вы можете 
указать этот атрибут: 


Сс1а55 КГоо(оБ)ес®): 
_ мефас1а55__ = зомефв1п9... 
а] 
После этого Руфоп будет использовать метакласс для создания класса ЕРоо. 


Если написать с1азз Еоо(оБесе), объект класса Роо не сразу создастся в па- 
мяти — Руфоп будет искать __тебас]азз__. Как только атрибут будет най- 
ден, он будет использоваться для создания класса Роо. В том случае, если 
этого не произойдет, РуВоп будет использовать фуре для создания класса. 
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Рассмотрим пример: 


с1азз Гоо (Ваг) : 
разз 


При таком объявлении Руоп проверит, есть ли атрибут __тевас]аз$_ _ у 
класса Еоо? Если он есть, создаст в памяти объект класса с именем Еоо с 
использованием того, что находится в __теас1аз$__. Если __ тебас]аз$__ 
не найден, то Рупоп будет искать его на уровне модуля и после этого по- 
вторит процедуру. В случае если он вообще не может найти какой-либо __ 
тебас]аз$ __, Рупоп использует собственный метакласс буре, чтобы создать 
объект класса. 


Наверное, вас интересует вопрос: что можно добавить в __теас]азз__. Да 
практически все, что может создавать классы. Как минимум фуре или его 
подклассы, а также все, что использует фуре. 


20.3.2. ПОЛЬЗОВАТЕЛЬСКИЕ МЕТАКЛАССЫ 


Основная цель метакласса — автоматическое изменение класса во время его 
создания. Обычно это делается для АР, когда нужно создать классы, соот- 
ветствующие текущему контексту. Например, нам нужно, чтобы все клас- 
сы в модуле должны иметь свои атрибуты, и они должны быть записаны в 
верхнем регистре. Чтобы решить эту задачу, можно задать __теас!аз$ _ на 
уровне модуля. 


Просто нужно сообщить метаклассу, что все атрибуты должны быть в верх- 
нем регистре. __тебас]азз__ действительно может быть любым вызывае- 
мым объектом, он не обязательно должен быть формальным классом. 


Начнем с очень простого примера с использованием функции: 


# метаклассу автоматически передается тот же аргумент, 
# который вы обычно передаете в `+уре` 
ЧеЕ пррег_а®ег (Еибаге_с1азз_паме, Еабиге_с1азз_рагепез, 
Еибоге_с1азз_а®г) : 
пит 
Возвращает объект класса со списком его атрибутов 
в верхнем регистре 


Рупоп. Полное руководство ОИС 2 ру&Воп 


# выбирает любой атрибут, который не начинается с "_"и 
переводит его 
# в верхний регистр 
иррегсазе_аеег = {} 
Еог паше, уа1 1п Еабаге с1аз5_ аеёг.1%епз (): 
1Е поЕ паме. каг зи1 ЕВ ('__'): 
иррегсазе а®Ег[паме.иррег()] = уа1 
е15е: 
пррегсазе ак+г[паме] = \уа1 


# Суре создаст класс 
гебигп фуре (Еабиге _с1а$$_паще, Еобиге_с1аз5_рагепез, 
иррегсазе афег) 


_ мефас1азз__ = иррег_а®г # это повлияет на все классы в 
модуле 


# Глобальный _пмефас1аз5__ не будет работать с "объектом", но мы можем 
# определить здесь _ мефас1азз _, чтобы воздействовать только на этот 
# класс, и он будет работать с дочерними элементами "объекта" 
с1аз$ Гоо\(): 

раг = 'Б1р' 


рг1п (Раза Е тг (Коо, "раг')) 
# Выводит: Еа1зе 
рг1пЕ (Раза Е г (Коо, 'ВАВ')) 
# Выводит: Тгие 


Е = Еоо() 
рг1пе (Е.ВАБ) 
# Выводит: 'Б1р' 


Теперь проделаем то же самое, но с использованием метакласса: 


# помните, что `$уре` - это такой же класс, как `56г` и `1108` 

# поэтому вы можете наследовать его 

с1азз ОррегАЕ+етгМефас1аз$ (фуре): 
# _ пем’ - это метод, который вызывается до _ 1118 _ 
# он создает объект и возвращает его 
# а метод _ 1 — просто инициализирует объект, переданный как параметр 
# вам нужно редко использовать _пем _, кроме случаев, когда вы хотите 
# контролировать создание объекта 
# В этом примере создаваемым объектом является класс и мы хотим 
# кастомизировать его, поэтому мы переопределяем __ печ 
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# Вы можете сделать некотору работу в __ 111 _ если вам это нужно 

# Некоторые особо продвинутые программисты переопределяют метод _ са11 _ 

# но мы не будем этого делать 

аеЕ __ пем _ (уррегае+г мефас1азз, Гааге с1аз$ папе, 
Еабаге_с1аз$_ рагеп®з, Еакиге_с1азз_аег): 


иррегсазе афег = {} 
Гог паме, уа1 1п Еабаге_с1аз5$_ аеег.1еетз (): 
1Е поф паме.звагЕзи1 В ('_'): 
иррегсазе_а*+г[паме .пррег()] = уа1 
е15е: 
иррегсазе_а*+г[паме] = уа1 


тебигп буре (Еабаге с1азз папе, Еабаге с1азз рагепез, аррегсазе а г) 


Это нельзя назвать объектно-ориентированным программированием, 
поскольку мы фуре не переопределяем, а вызываем напрямую. Давайте из- 
меним это: 


с1аз5 ОррегАЕЕгМефас1а$$ (фуре): 


аеЕ _ пем__ (пррегае®г_мефас1аз5, Еабаге_с1аз5$ паме, 
Еобоге с1аз$ рагепез, Еафоге с1аз$_а®ёг): 


иррегсазе_афег = {} 
Бог паше, уа1 1п Еафоаге с1аз5_аеЕг.1®етз (): 
1Е поф паме.зфагЕзи1еВ ('__'):; 
иррегсазе_а{%г [паме .пррег()] = уа1 
е1зе: 
иррегсазе ак&г[паме] = уа1 


# Повторное использование метода фуре.__ печ 

# Никакой магии, это базовое ООП 

гебогп Суре. пем (пррегабЕг пебас1]аз5, Рабаге с1аз$ папе, 
Еобиге с1аз$ рагеп®з, пррегсазе_а®ег) 


Наверное, вы заметили аргумент иррегайг_теас]азз. Этот метод первым 
аргументом получает текущий экземпляр. Точно так же, как и 5е!} для 
обычных методов. Имена аргументов такие длинные для наглядности, но 
для зе[{ все имена имеют названия обычной длины. Поэтому реальный ме- 
такласс будет выглядеть так: 


с1аз5 ОррегАЕЕкМе{фас1азз (фуре) : 


Рупоп. Полное руководство ыы г руЕпоп 


аеЕ _ пем _ (с15з, с15паще, Базез, Яс®): 
иррегсазе_ ае%г = {} 
ог паме, уа1 1п ас®е.16емз(): 
1Е поЕ паме.збакезм1еВ ('__'): 
иррегсазе ае*г[паме .пррег()] = уа1 
е1зе: 
иррегсазе_а г [паме] = уа1 


гебагп $уре. пеи _(с13, с15паме, Разез, пррегсазе аеег) 


Используя метод 5ирет, можно сделать код более "чистым": 


с1аз5 ОррегАЕЕгМефас1аз$ (фуре) : 
аеЁЕ __ пем___(с1з, с1зпаме, Базез, @с®): 
иррегсазе абег = {} 


ог паме, уа1 1п асе.1еемз(): 
1Е поЕ паше. зв агЕзм1 ЕВ ('__'): 


иррегсазе_а%®г [паме .иррег (.) ] = уа1 
е15е: 
иррегсазе аеег[паме] = уа1 
гееагп зирег(ОррегАЕЕгМефас1азз$, с1$). _пем  (с1$, 


с1зпаме, Базез, пррегсазе_аеег) 


Собственно, это все, что вам нужно знать о метаклассах. Причина слож- 
ности кода, который использует метаклассы, даже не в самих метаклассах. 
Код становится сложным, поскольку обычно метаклассы ИСПОЛЬЗУуют ДЛЯ 
сложных задач, основанных на наследовании и манипуляции такими пере- 
менными, как ее. Также посредством метаклассов вы можете: 


® перехватить создание класса 
® изменить класс 


® вернуть измененный класс 


20.3.3. ИСПОЛЬЗОВАНИЕ МЕТАКЛАССОВ ВМЕСТО 
ФУНКЦИЙ 


Спрашивается, зачем использовать классы метаклассов вместо функций? А 
тому есть несколько причин: 
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» Более понятные идентификаторы. Например, когда вы читаете 
ОррегАИгМеасазз((уре), вы понимаете, что будет дальше. 


е® Можно использовать ООП. Метакласс может наследоваться от мета- 
класса, переопределять родительские методы. 


® Можно лучше структурировать свой код. Вряд ли вы будете использо- 
вать метаклассы для чего-то простого. Обычно это более сложные зада- 
чи. Возможность создавать несколько методов и группировать их в од- 
ном классе очень полезна, чтобы сделать код более удобным для чтения. 


® Можете использовать __пе\__, _Ши__ и __ са] _. Это открывает про- 
стор для творчества. Обычно все это можно сделать в __пе\ __, но неко- 
торым программистам просто удобнее использовать __шй__. 


20.4. Генерация кода 


Как уже было отмечено в начале этой главы, динамическая генерация кода 
— самый сложный способ метапрограммирования. Руоп предоставля- 
ет инструменты, позволяющие создавать и выполнять код, атакже вносить 
изменения в уже откомпилированные части кода. Все это открывает прак- 
тически безграничные возможности метапрограммирования. К сожалению, 
все это настолько сложные материи, что данному подходу можно посвятить 
отдельную книгу. Можете считать данный раздел как указатель направле- 
ния. Мы укажем путь, по которому вы сможете дальше развиваться само- 
стоятельно, если это вам нужно. 


Ру!оп содержит три встроенные функции, позволяющие вручную выпол- 
нить, вычислить и откомпилировать произвольный код Руоп - ехес, еиа[, 
сотрие. 


Сигнатура функции ехес() выглядит так: 


ехес (о5]ес+, 91оЪа1, 1оса13з) 


Данная функция позволяет выполнить код Руфоп. Элемент оБзесё должен 
быть объектом кода (см. функцию сотрИе) или же строкой, представляю- 
щим один оператор или последовательность нескольких. Аргументы ра! 
и юса[ - это глобальные и локальные пространства имен для исполняемо- 
го кода, которые являются необязательными. Если они не указаны, то код 
будет выполнен в текущем пространстве. Если указаны, то &юра/ должен 
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быть словарем, а [оса/ может быть любым объектом отображения, он всегда 
возвращает №ме. 


Сигнатура функции еба/ выглядит так: 


еуа1 (ехргезз1оп, 91оБа1, 1оса13) 


Данная функция используется для вычисления выражения и возвращения 
его значения. Она похожа на ехес(), но ехртезяот — это одно выражение, а 
не большой кусок кода. Функция возвращает значение вычисленного вы- 
ражения. 


Сигнатура функции сотр? такая: 


сопр11е (зоагсе, Н1епаме, поае) 


Компилирует источник в объект кода или АЗТ. Исходный код предостав- 
ляется в качестве строкового значения в аргументе 50иже. Здесь [епате — 
это файл, из которого читается код. Если связанного файла нет (например, 
если он был создан динамически), обычно используется значение <зтв>. 
Режим — ехес (последовательность операторов), еоа/ (одно выражение) или 
те (один интерактивный оператор, например, в интерактивной сессии 
Ру оп). 


Легче всего начать работу с функциями ехес() и еуа](), поскольку функции 
работают со строками. Если вы уже программировали на Руогп, то навер- 
няка сможете сформировать рабочий исходный код из программы. 


Наиболее полезная функция в контексте метапрограммирования — это 
функция ехес(), поскольку она позволяет выполнить любую последова- 
тельность операторов Руоп. Однако при работе с этой функцией нужно 
быть осторожным. Вас должно беспокоить словосочетание "любую после- 
довательность". Не нужно бояться сбоя Ру{оп - это не самое страшное. 
Самое страшное -— это возможные проблемы с безопасностью вашего при- 
ложения, что может вам очень дорого стоить. Другими словами, функции 
ехес() и еуа[() могут сделать ваше приложение уязвимым, поэтому нужно 
с особой осторожностью относиться к тому, что вы передаете на вход этим 
функциями. Одно дело, если код генерируете вы, другое дело, если его вво- 
дит пользователь или он поступает откуда-то извне (база данных, внешний 
файл ит.д.). 
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Даже если вы 100% доверяете входным данным (например, пишете при- 
ложение исключительно для себя, и входные данные будете формировать 
исключительно вы), вы должны понимать, что результаты работы вашей 
программы могут быть весьма неожиданными. 


Первое, с чем вам придется столкнуться - это производительность. Перед 
тем, как поговорить о ней, давайте разберемся, что делает РуШфогп, если вы 
импортируете модуль (йтро" юо): 


1. Он выполняет поиск модуля. Это происходит при просмотре информа- 
ции из 5у$.ра разными способами. Есть встроенная логика импорта, 
есть ловушки импорта и, в целом, в этот процесс задействовано довольно 
много магии, о которой мы сейчас не будем говорить. 


2. После того, как модуль найден, Руфоп, в зависимости от того, найден 
откомпилированный код (.рус) или исходный (.ру), он производит неко- 
торую работу. Если доступен байт-код и контрольная сумма соответству- 
ет текущей версии интерпретатора, временная метка файла байт-кода 
новее или равна исходной версии, он его загружает. Если байт-код от- 
сутствует (есть только ‚ру-файл) или же устарел, он загрузит исходный 
файл и откомпилирует его в байт-код. Для этого он проверяет магиче- 
ские комментарии в заголовке файла на предмет настроек кодирования 
и декодирует в соответствии с этими настройками. Он также проверит, 
существует ли специальный комментарий ширины табуляции для обра- 
ботки табуляции как чего-то другого, кроме 8 символов, если это необ- 
ходимо. Некоторые хуки импорта затем будут генерировать файлы .рус 
или сохранять байт-код в другом месте (__русасБе__) в зависимости от 
версии и реализации Ру(Воп. 


3. Интерпретатор РуШФоп создает новый объект модуля (вы можете сделать 
это самостоятельно, вызвав ппр.пе\м_тодще или создав экземпляр &урез. 
МодшеТуре - это эквивалентно) с собственным именем. 


4. Если модуль был загружен из файла, устанавливается ключ __#Ё]е__. 
Система импорта также будет следить за тем, чтобы __расКаве _ и 
ра были установлены правильно, если пакеты задействованы до 
выполнения кода. Хуки импорта также устанавливают переменную __ 
]оа4ег__. 


5. Интерпретатор Руфоп выполняет байт-код в контексте словаря модуля. 
Таким образом, локальные и глобальные фреймы для исполняемого кода 
являются атрибутом __41сё ___ этого модуля. 


6. Модуль вставляется в 5уз.тоди[ез. 
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Ни один из вышеперечисленных шагов никогда не передавал строку клю- 
чевому слову или функции ехес. Это, очевидно, правда, потому что все эти 
действия происходят глубоко внутри интерпретатора Ру{Воп, если вы не 
используете ловушку импорта, написанную на Руоп. Но даже если интер- 
претатор Ру{Воп был написан на Руогп, он никогда не передал бы строку в 
функцию ехес. Итак, что бы вы хотели сделать, если хотите сами преобразо- 
вать эту строку в байт-код? Вы бы использовали встроенную компиляцию: 


>>> сое = сотшр1]1е('а = 1 +2', '<36г1п4а>', 'ехес') 
>>> ехес соае 

>>> рг1аЕ а 

3 


Как видите, ехес тоже успешно выполняет байт-код (не обязательно переда- 
вать строку). Поскольку переменная кода на самом деле является объектом 
типа сое, а не строкой. Второй аргумент для компиляции — подсказка име- 
ни файла. Если мы компилируем из реальной строки, мы должны указать 
значение, заключенное в угловые скобки, потому что это то, что будет делать 
Рупоп. < 1тв> и <$4т> — общие значения. Если у вас есть файл, укажи- 
те здесь фактическое имя файла. Последний параметр может быть одним 
из "ехес", "еуа[" или "зшёе". Первый - это то, что использует ехес, второй 
— то, что использует функция еоа/. Разница в том, что первый может содер- 
жать операторы, второй — только выражения. '5зшпе' — это разновидность 
гибридного режима, который бесполезен ни для чего, кроме интерактивных 
оболочек. Он существует исключительно для реализации таких вещей, как 
интерактивная оболочка Ру{оп, и очень ограничен в использовании. 


Однако здесь мы уже использовали функцию, которую вы никогда и никог- 
да не должны использовать: выполнение кода в пространстве имен вызыва- 
ющего кода. Что делать вместо этого? Выполнить в новой среде: 


>>> сое = сопр11е('а = 1 +2', '<56г1па>', 'ехес') 
>>> п = {} 

>>> ехес соае 1п пз 

>>> рг1пЕ п$['а'] 
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Зачем так делать? Более понятное средство для начинающих, поскольку 
ехес без словаря должен обойти некоторые детали реализации в интерпре- 
таторе. Мы поговорим об этом позже. 


Примечание. На данный момент: если вы хотите использовать 
ехес и планируете выполнять этот код более одного раза, убе- 
дитесь, что вы сначала скомпилировали его в байт-код, а затем 
выполняете только этот байт-код, и только в новом словаре в 
качестве пространства имен. 


Однако в РуФоп 3 оператор ехес ... т исчез, и вместо этого вы можете ис- 
пользовать новую функцию ехес, которая принимает глобальные и локаль- 
ные словари в качестве параметров. 


А вот теперь мы можем поговорить о производительности. Насколько бы- 
стрее выполняется байт-код по сравнению с созданием байт-кода и его вы- 
полнением: 


| 


$ руЕПоп -мЕпе1е -$з 'соае "а =2; Ь = 3; с=а *Ь"' "'ехес 
соае' 


10000 1оорз, Безе оЕЁ 3: 22.7 изес рег 1оор 


$ руЕБоп -мЕ1те1Е -з 'соае сотр11е ("а = 2; Ь = 3; с=а * 
ь", 

"<3Ех1па>", "ехес")' 'ехес соае' 
1000000 1оорз, резЕ оЕЁ 3: 0.765 изес рег 1оор 


В 32 (1!) раза быстрее даже на таком простом примере. И чем больше у вас 
кода, тем хуже становится ситуация. Почему так происходит? Поскольку 
синтаксический анализ кода Ру\фоп и преобразование его в байт-код — 
дорогостоящая операция по сравнению с оценкой байт-кода. 


Хорошю, урок усвоен. Сначала компиляция, а затем выполнение уже отком- 
пилированного кода. Но что еще нужно учитывать при использовании ехес? 
Следующее, что вы должны помнить, это огромная разница между глобаль- 
ной и локальной областью видимости. Хотя и глобальная, и локальная об- 
ласть видимости используют словари в качестве хранилища данных, 
последняя на самом деле нет. Локальные переменные в Ру{роп просто бе- 
рутся из локального словаря фрейма и помещаются туда по мере необхо- 
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ДИМОСТИ. Для всех вычислений, которые происходят между ними, словарь 
никогда не используется. Вы можете быстро убедиться в этом сами. 


Выполните в интерпретаторе Ру Фоп следующее: 


>>> а = 42 
>>> 1оса1з() ['а'] = 23 


>>> а 
23 


Работает как положено. Почему? Потому что интерактивная оболочка 
РуШФоп выполняет код как часть глобального пространства имен, как и лю- 
бой код вне функций или объявлений классов. Локальная область видимо- 
сти - это глобальная область: 


>>> 910Ба1$() 15$ 1оса13() 
Тгоае 


Что произойдет, если мы попытаемся сделать то же самое, но на уровне 
функции: 


>>> аеЕ Еоо(): 

... а = 42 

... 10са13() ['а'] = 23 
.. гебогп а 


>>> Еоо() 
42 


Совсем не то, что мы ожидали, правда? Но это еще раз красочно демонстри- 
рует, что локальные переменные - это не совсем локальные, по крайней 
мере, в контексте программы, а не функции. Об этом нужно помнить просто 
при программировании, не говоря уже об использовании ехес/ета]. 


А что можно сказать о производительности кода, выполняемого в глобаль- 
ной области по сравнению с кодом, который выполняется в локальной об- 
ласти? Это намного сложнее измерить, потому что модуль Итей по умол- 
чанию не позволяет нам выполнять код в глобальной области видимости. 
Поэтому нам нужно будет написать небольшой вспомогательный модуль, 
который эмулирует это: 
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соде 91ора1 = сомр11е(''' 


зим = 0 
Бог х 1п хкгкапае (500000) : 
зим += х 


тт, ТЗЗЕЕЬно>", "ехёс“) 
со4е 1оса1 = сотр11е(''' 


аеЕ Е(): 
зим = 0 
Гог х 1п хгапае (500000) : 


зим += х 
"у, "ОЕ", чехес!’) 


АеЕЁ +езЕ 91оЪа1 () : 
ехес соае_41ора1 1пт {} 


АеЕ +ез®_1оса1(): 


п5: = {} 
ехес сое 1оса1 1п пз 
п5['Е'] () 


Здесь мы дважды компилируем один и тот же алгоритм в строку. Один раз 
напрямую глобально, один раз — завернутый в функцию. Получается, что у 
нас есть две функции. Первая выполняет этот код в пустом словаре, вторая 
выполняет код в новом словаре, а затем вызывает объявленную функцию. 
А теперь мы можем использовать йтей для вычисления нашей скорости: 


$ руЕПоп -шЕие1е -з 'Егом ехессотр11е проге {ез® 91оБа1 аз {' '4()' 
10 1оорз, БезЕ оЕ 3: 67.7 шзес рег 1оор 


$ руЕПоп -мЕШе1е -з 'Егощ ехессотр11е проге 6ез® 1оса1 аз ©' '©()' 
100 1оорз, Безе оЕЁ 3: 23.3 пзес рег 1оор 


Снова мы получили прирост производительности, правда, не такой ощути- 
мый, как в прошлый раз. Однако, мы используем всего 100 циклов, при этом 
прирост составил почти 200%, то есть мы стали в три раза быстрее, и один 
циклу нас выполняется 23.3 секунды против 67.7 секунд. 


Почему так получается? Это связано с тем, что быстрые локальные пере- 
менные быстрее словарей. В локальной области видимости Руоп отсле- 
живает имена переменных, о которых он знает. Каждой из этих переменных 
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присваивается номер (индекс). Этот индекс используется в массиве объ- 
ектов РуФоп вместо словаря. Он вернется к словарю только в том случае, 
если это необходимо (в целях отладки, в случае использования ехес и т.д.). 
Несмотря на то, что ехес все еще существует в Руфоп 3 (как функция), вы 
больше не можете переопределять переменные в локальной области. Ком- 
пилятор Руоп не проверяет, используется ли встроенная функция ехес, и 
из-за этого не будет неоптимизировать область видимости. 


Все вышеперечисленные знания полезно знать, если вы планируете ис- 
пользовать интерпретатор Ру®оп для интерпретации вашего собственного 
языка путем генерации кода РуПоп и компиляции его в байт-код. Так, на- 
пример, работают механизмы шаблонов, такие как Мако, Л па2 или СепзЫ. 


Однако, большинство людей используют оператор ехес для выполнения 
реального кода Руфоп из разных мест. Очень популярный кейс — выпол- 
нение файлов конфигурации как кода Ру(оп. Так, например, делает ЕазК. 
Обычно это вполне нормально, потому что вы не ожидаете, что ваш файл 
конфигурации будет местом, будет реализован реальный код. Однако есть 
люди, которые используют ехес для загрузки реального кода Руфоп, объ- 
являющего функции и классы. Это очень популярный подход в некоторых 
системах плагинов и фреймворке \еЬ2ру. 


Почему это не очень хорошая идея? Да потому что она ломает некоторые 
негласные соглашения относительно кода Руфогп, а именно: 


1. Классы и функции принадлежат модулю. Это основное правило спра- 
ведливо для всех функций и классов, импортированных из обычных моду- 
лей: 


>>> Егом хш1.зах.захоЕ11$ 1трог® апобеаеег 
>>> апофеаеег. _мода1е__ 
'хт].зах.захо*115' 


Почему это важно? Посмотрим, как работает Расе: 


>>> рускК1е.1оа4з (р1ск1е.ааптрз (апо*еае+г)) 
<Еапсе1оп аообеаЕЕхг аф 0х100534950> 

>>> апофеае ег. _мода1е _ = 'Ёаке' 

>>> руск1е. 1оаа$ (р1сКкК1е.аитрз (апобеа ег) ) 
ТгасеБасКк (мозЕ гесепЕ са]11 1аз): 
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р1ск1е.Р1скК11п3Еггохг: Сап'® р1ск1е апобеа® Ех: 16'5$ по Еоцпра 
аз ЕаКке.чиокеаеег 


Если вы используете ехес для выполнения кода РуФоп, будьте ГОТОВЫ К 


тому, что некоторые модули, такие как расе, 1пзрес®, ркёи@1, рудос и, воз- 
можно, некоторые другие, которые зависят от них, не будут работать долж- 
ным образом. 


2. В Рупоп встроен циклический сборщик мусора, классы могут иметь де- 
структоры, а завершение работы интерпретатора приводит к прерыванию 
циклов. Что это значит? СРуфоп внутренне использует рефсчет. Один из 
многих недостатков подсчета ссылок заключается в том, что он не может 
обнаруживать циклические зависимости между объектами. Таким образом, 
в какой-то момент РуФоп представил циклический сборщик мусора. 


Однако Ру'оп также позволяет использовать деструкторы для объектов. 
Однако деструкторы означают, что циклический сборщик мусора пропу- 
стит эти объекты, потому что он не знает, в каком порядке он должен уда- 
лить эти объекты. | 


Теперь давайте посмотрим на невинный пример: 


с1аз$ Коо (оБ]ес®) : 
4еЕ __ае1  (зе1Е): 
рг1пЕ 'Бе1екеа' 
оо = Еоо() 


Давайте выполним этот файл: 


$ руЕВоп Еезе.ру 
Ре1ефеа 


Выг Ълядит нормально. Теперь выполним его же через ехес: 


>>> ехесН1е ('+езе.ру', {}) 
>>> ехесй1е ('+езе.ру', {}) 
>>> ехесН1е ('+езе.ру', {}) 
>>> пароге ас 

>>> ас.со11есе () 
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Он что-то почистил, но он никогда бы не очистил наш экземпляр Еоо. Что 
же происходит? Происходит неявный цикл между /00 и самой функцией 
__4е] _. Функция знает область видимости, в которой она была создана, и 
из экземпляра __4е| _ -> #офЪа! зсоре -> о, у нее есть хороший цикл. 


Теперь, когда мы знаем причину, почему этого не происходит, если у вас 
есть модуль? Причина в том, что Ру оп выполняет некоторый трюк при 
закрытии модуля. Он переопределит все глобальные значения, которые не 
начинаются с подчеркивания с №пте. Мы можем легко убедиться в этом, 
если введем значение /юо вместо Ое[ееа: 


с1азз Роо (об]ес®) : 
ЧеЁЕ _ 9е1_  (зе1Е): 
рг1пЕ Еоо 
Еоо = ГЕоо() 


Что получим в итоге? Конечно, №пе: 


$ рубпоп Еез®.ру 
Мопе 


Поэтому при использовании ехес() и компании нужно быть предельно 
осторожным, поскольку это может стать причиной утечек памяти. 


3. Срок службы объектов. Глобальное пространство имен сохраняется 
с момента его импорта до момента завершения работы интерпретатора. С 
ехес вы, как пользователь, больше не знаете, когда это произойдет. Это мог- 
ло случиться раньше в случайном месте. \меБ2ру здесь является частым на- 
рушителем. В меБ2ру волшебно исполняемое пространство имен приходит 
и уходит с каждым запросом, что является очень неожиданным поведением 
для любого опытного разработчика Руфоп. 


Наконец, в завершении этой главы поговорим о РНР и Ру`оп. Многие 
опытные веб-разработчики знакомы с обоими этими языками. Помните, 
что Руфоп - это не РНР Не пытайтесь обойти идиомы Руфоп, потому что 
какой-то другой язык (наш любимый РНР) делает это иначе. Пространства 
имен находятся в Руоп по какой-то причине, и то, что он дает вам ин- 
струмент ехес, не означает, что вы должны использовать этот инструмент. 
Язык С дает вам зейтр и юпаутр, но вы будете очень осторожны при их 
использовании. Комбинация ехес и сотрие — мощный инструмент для всех, 
кто хочет реализовать специфичный для предметной области язык поверх 
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Руоп, или для разработчиков, заинтересованных в расширении (а не об- 
ходе) системы импорта Руоп. 


Однако \еЪ2ру и его использование ехес/Ше() - не единственные наруши- 
тели в веб-сообществе Руфоп. УМегктеий также изрядно злоупотребляет 
соглащениями РуШфогп. Система импорта по требованию вызывает больше 
проблем, чем решает, и в настоящее время разработчики Ру{поп от нее от- 
казываются (несмотря на все свое нежелание этого делать). 


Б}ап5о также злоупотреблял внутренними компонентами Ру{оп. Она ге- 
нерировала код Ру{Воп на лету и полностью меняла семантику (до такой 
степени, что импорт исчезал без предупреждения!). Разработчики О)апёо 
тоже усвоили урок и исправили эту проблему. То же самое касается и \еБ. 
ру, который злоупотреблял оператором римЁ для записи во внутренний 
локальный буфер потока, который затем был отправлен в качестве ответа 
браузеру. Также кое-что, что оказалось плохой идеей, было впоследствии 
удалено. 


Несмотря на все возможности, открываемые функцией ехес(), мы призыва- 
ем отказаться от ее использования в пользу обычных модулей Ру{Воп. Если 
разработчик Руоп начнет свое путешествие в запутанном мире непра- 
вильно выполненных модулей Ру!Фог, он будет, как минимум, сбит с толку, 
когда продолжит свое путешествие в другой среде Руфоп. Наличие разной 
семантики в разных фреймворках/модулях/библиотеках очень вредно для 
Руоп как среды выполнения, и как языка. 


ГЛАВА 21. 
КОНТРОЛЬ КОДА 
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В современном мире невозможно обойтись без системы управления верси- 
ями (она же система контроля версий). Программные продукты становятся 
все сложнее и сложнее, над ними работает целая команда и управлять та- 
ким проектом без системы контроля версий практически невозможно. Даже 
если вы - программист-одиночка, система управления версиями так же бу- 
дет полезна, ведь порой очень сложно вспомнить, какие изменения вноси- 
лись в код неделю назад, не говоря уже про более длительные периоды. А 
в случае с командной работой. система контроля кода подскажет не только, 
что и когда изменялось, но и кто вносил те или иные изменения. 


21.1. Введение в системы контроля 
версиями 


Системы управления версиями (Ут5юп Сопо[ 5уяетз, УС5) предостав- 


ляют возможность общей работы над любыми файлами, но все их преиму- 
щества можно получить только при работе с текстовыми файлами. И при 
этом совершенно не важно, на каком языке вы программируете, вообще не 
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важно, программируете ли вы или пишете роман. Главное, чтобы основным 
типом обрабатываемой информации был текст. 


Системы контроля версиями (СКВ) бывают централизованными и рас- 
пределенными. Централизованная СКВ представляет собой один сервер 
с файлами, позволяющий пользователям вносить свои и видеть чужие из- 
менения в контролируемый набор файлов, называемый проектом. Прин- 
цип очень и очень прост — каждый может скопировать нужные файлы на 
свой компьютер, внести в них изменения, а после — загрузить изменения 
на сервер. После применения изменений генерируется номер версии. Дру- 
гие пользователи могут получить измененные файлы путем синхронизации 
их копий проекта через механизм обновления. Другими словами, если вы 
и Вася работаете над проектом, а Вася вечером внес изменения в какие-то 
файлы, то спустя некоторое время, например, утром, когда вы включите 
компьютер и приступите к работе, вы: 


® Получите самую новую версию проекта. 
® Увидите, кто и какие изменения вносил в предыдущую версию. 


® Сможете сравнить версии файлов. 


На вашем компьютере будет установлено специальное программное обе- 
спечение, которое "видит", что проект изменен и загрузит измененные фай- 
лы на ваш компьютер. Аналогично, если вы внесете изменения в проект, 
они будут загружены на сервер и другие члены команды увидят, какие из- 
менения вы вносили. Это очень удобно, а главное позволяет с точностью до 
последнего символа контролировать код. 


Такой процесс прекрасно работает в проектах, над которыми трудятся 
несколько разработчиков и где относительно небольшое количество фай- 
лов. Но все становится сложнее, когда вырастает количество разработчиков 
и размер кода. Сложные изменения часто затрагивают множество файлов, 
разные разработчики практически в одно и то же время вносят изменения, 
что порождает цепочку не совсем логичных версий, а проект разрастается 
до таких размеров, что некоторые программисты просто не в состоянии хра- 
нить у себя локальную копию всего проекта. 


Назревают две проблемы: 


1. Программист может долго работать только в своей локальной копии без 
резервного копирования. 
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2. Сложно делиться своей работой с другими, пока она не отправлена в 
хранилище, а отправлять ее без проверки и тестирования означает по- 
ставить под угрозу работу всего проекта. 


В централизованной СКВ подобные проблемы решаются посредством от- 
ветвлений и слияний. От основного потока изменения могут ответвляться 
ветви (форки), которые снова сливаются в основной поток. Но в этом слу- 
чае возникает другая проблема. Представьте себе, что есть основной поток, 
над которым работает множество программистов. Программист Вася соз- 
дает свой форк и вносит в него изменения, работает над проектом неделю 
или даже больше и затем хочет выполнить слияние своей ветки с основным 
проектом. В процессе слияния выясняется, что пользователь Марк также 
вносил изменения в файлы, которые правил Василий - уже после того, как 
Василий создал свой форк. Чьи изменения считать правильными — Марка 
или Василия? 


Вот в этом и заключаются основные недостатки централизованной СКВ: 


1. Ветвление и слияния сложно организовать. В сложных проектах такая 
организация управления кодом может превратиться в настоящий ноч- 
ной кошмар. 


2. Поскольку система централизована, нельзя зафиксировать изменения в 
автономном режиме. То есть вы не можете зафиксировать результаты 
своей работы за вчера, чтобы сравнить их с сегодняшними. Вам нужно 
только отправлять изменения на сервер, чтобы выполнить централи- 
зованный сопипй, что в свою очередь породит создание новой версии. 
Когда над проектом работает с десяток программистов (а это немного) 
и каждый будет ежедневно делать коммит, то накопиться очень много 
версий, в которых очень сложно будет разобраться. 


3. Такая схема практически не работает для проектов, где у компаний есть 
собственный филиал программного обеспечения и нет центрального 
хранилища, в котором бы у каждого была своя учетная запись. 


Внимание! Еще нужно помнить о следующем недостатке цен- 
трализованной СКВ. У каждого клиента есть копия всего исход- 
ного кода и внесенных изменений. В этом случае, если один из 
серверов выйдет из строя, любой клиентский репозиторий мо- 
жетбыть скопирован на другой сервер для продолжения работы. 
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Несмотря на эти недостатки, централизованные СКВ все еще популярны в 
небольших проектах и даже в крупных компаниях за счет инертности кор- 
поративной среды. Другими словами, когда-то, лет 10 назад, решили, что 
будут использовать систему А и всеэти 10 лет она используется, потому что 
так принято. 
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В качестве примера централизованных СКВ можно привести ЗиБуег®юп 
(ЗУМ) и бучет СопсиггепЕ Уегз1оп (СУ5). 


Многие крупные проекты из-за недостатков централизованных СКВ пе- 
решли на распределенную архитектуру. Распределенные СКВ решают не- 
достатки централизованных коллег. Они размещаются не на основном сер- 
вере, с которым работают программисты, а на равноправных (реег-юо-реег) 
узлах. У каждого программиста есть свой независимый репозиторий для 
проекта, и он синхронизирует его с другими репозиториями. 


Здесь больше свободы. Например, Марк может загрузить файлы из какого- 
то основного хранилища (пусть оно называется РВ]). Марк вносит измене- 
ния в некоторые файлы. Василий загружает файлы из хранилища Марка и 
тоже вносит изменения. Затем Василий отправляет изменения в РК]. Де- 
нис загружает файлы из РК] и вносит в них изменения, а затем загружает 
ихв РК]. 


Другими словами, здесь есть какой-то один центральный репозиторий, но 
вам не обязательно с ним работать. Вы можете использовать репозитории 
других программистов, в зависимости от того, как организована работа 
людей и управление проектом. Здесь больше нет какого-то центрального 
сервера, на который пользователи вносят изменения, а менеджер проекта 
определяет стратегию управления кодом - загрузки, выгрузки, внесения 
изменений. 


Недостаток распределенной системы в том, что программисты вынуждены 
больше думать. В распределенной системе нет больше какого-то глобально- 
го номера, с которым можно сверяться. Таким образом, нужно задейство- 
вать дополнительные текстовые метки (теги), которые могут быть присо- 
единены к версии. 


При работе с распределенной системой получается, что каждый может вно- 
сить какие-либо изменения, загруженные у кого-либо. Может получиться 
бардак. Поэтому при работе с распределенной системой также создают цен- 
тральный сервер, но его назначение совсем иное, чем у централизованных 
СКВ. Этот сервер представляет собой хаб, позволяющий всем программи- 
стам одновременно использовать свои изменения в одном месте, а не зани- 
маться загрузкой и выгрузкой друг у друга. Такой репозиторий часто назы- 
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вается вышестоящим и используется также в качестве резервного для всех 
изменений, выполняемых в отдельных репозиториях всех членов команды. 


Для объединения доступа к коду в распределенной СКВ используются раз- 
личные подходы. Самый простой заключается в создании сервера, который 
будет выполнять функцию обычного централизованного сервера, и каждый 
программист может вносить изменения в общий поток. Но такой подход не 
позволит вам получить все преимущества распределенной СКВ, поскольку 
работа будет организована так же, как и в случае с централизованной СКВ, 
а поменяется просто название системы СКВ. Будете использовать С, гор- 
до заявлять об этом, а работа будет построена так же, как в случае с ЗУМ. 
Для небольших проектов такой вариант использования распределенной 
СКВ допускается — чтобы программисты сразу привыкали к использова- 
нию нормальной системы контроля версий. В сложных проектах принято 
использовать другой подход, при котором на сервере создаются несколько 
репозиториев с разными уровнями доступа: 


» Нестабильный репозиторий - в него может вносить изменения каждый 
программист. 


® Стабильный репозиторий - с него может выгружать файлы любой про- 
граммист, а вносить изменения могут только менеджеры проекта — они 
решают, что нужно изменять, какие изменения нужно вносить из неста- 
бильного репозитория. 


® Релизный репозиторий - используется для релизов, доступен только для 
чтения. 


При таком подходе каждый участник может вносить изменения, а менед- 
жеры могут решать, чьи изменения включить в стабильный репозиторий, а 
какие - нет. 


Какую систему выбрать -- централизованную или распределенную? Сейчас 
мы сэкономим вам кучу времени, и вы перестанете ломать голову над этим 
вопросом. Забудьте о централизованных системах -— это пережиток прошло- 
го и если вы только выбираете, какую систему СКВ использовать, ни в коем 
случае не выбирайте централизованные системы. Только распределенная. 


Хорошо, следующий вопрос -— какую распределенную систему выбрать? 
Здесь тоже все просто — используйте Си. СИ - это самая популярная рас- 
пределенная система управления версиями, знаменитая тем, что была соз- 
дана Линусом Торвальдсом (создатель Глпих) для работы над кодом ядра 
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Ппих, когда потребовалось отказаться от патентованного ПО ВиКеерег, 
которое использовалось ранее для работы над кодом ядра. 


С — лучшая, но не идеальная система. В том, что она лучшая - никто не 
сомневается, ведь она используется для управления кодом ядра пах - это 
очень сложный проект, содержащий тонны кода (когда количество строк 
кода в ядре Г4пих превысило 15 миллионов, эти строки перестали считать!). 
Но СИ также имеет свои недостатки. В первую очередь — это довольно 
сложная система, особенно для новичков. В последнее время эта проблема 
частично решается наличием специального ПО, облегчающего работу с СК, 
например, СиНаЬ ОезКбор (рис. 21.3). Приложение позволяет создавать ко- 
пию репозитория, выгружать изменения в репозиторий, просматривать эти 
изменения и т.д. Все же удобнее, чем командная строка. 


Да, вы будете привязаны к сервису СИНиЬ. Си Ни - это крупнейший веб- 
сервис для хостинга ИТ-проектов и их совместной разработки, основан на 
системе СК. С одной стороны, привязка к СИНур, с другой - этот хостинг 
бесплатный, за него не нужно платить, не нужно разворачивать отдельный 
сервер для СЁ, можно создать репозиторий, скачать СИНиЬ ОезК®ор и при- 
ступить к работе. 


Рис. 21.1. Приложение СИНиЬ ОезКюр 
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Здесь важно понимать разницу между СЁ и СиНиБ. СИНчЬ — сервис он- 
лайн-хостинга репозиториев, обладающий всеми функциями распределен- 
ного контроля версий и функциональностью управления исходным кодом 
— все, что поддерживает СЁ и даже больше. Также СИНиЬ может похва- 
статься контролем доступа, багтрекингом, управлением задачами и вики 
для каждого проекта. 


Ск-репозиторий, загруженный на СИНуВ, доступен с помощью интерфей- 
са командной строки СЁ и Ск-команд. Также есть и другие функции: доку- 
ментация, запросы на принятие изменений (ри[ тедие5{5), история комми- 
тов, интеграция со множеством популярных сервисов, ета|-уведомления, 
эмодзи, графики, вложенные списки задач, система @упоминаний, похожая 
на ту, что в Ти1ет, и т.д. 


Другими словами, СЁ — это инструмент, а СИЕНчь - это сервис, основанный 
на этом инструменте. СЁ - это как собственный автомобиль, а СИНиь - это 
как автомобиль напрокат, только в отличие от прокатного автосервиса, он 
является бесплатным. 


21.2. Знакомство с СЁ 


СЕ — это распределенная система контроля версий, созданная, как уже от- 
мечалось, создателем ядра 1лпих Линусом Торвальдсом для работы над ис- 
ходным кодом ядра. До появления СЁ для разработки ядра Глпих исполь- 
зовался коммерческий продукт — ВЁКеерег УС$, который обеспечивал 
сложные операции, недоступные в бесплатных системах контроля версий 
того времени, таких как КС$ и СУЗ (СопситетЕ Уегяюп Зует). Однако 
компания, владеющая ВЁКеерег, установила дополнительные ограничения 
на его "свободную" версию, выпущенную в 2005 году, и сообщество Глпих 
поняло, что ВиКеерег больше не может использоваться. 


Тогда Линус начал искать альтернативные решения. Сторонясь коммерче- 
ских решений, он изучил пакеты бесплатного программного обеспечения, 
но нашел те же ограничения и недостатки, которые были и раньше. Что же 
не устраивало его в существующих СКВ? Каковы были неуловимые недо- 
стающие возможности или характеристики, которые Линус хотел и не мог 
найти? 


РАСПРЕДЕЛЕННАЯ РАЗРАБОТКА 


Есть много граней распределенной разработки и Линус хотел новую УС$, 
которая бы покроет большинство из них. Она должна поддерживать парал- 
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лельную, а также независимую и одновременную разработку в частных ре- 
позиториях без потребности в постоянной синхронизации с центральным 
репозиторием, который мог бы сформировать узкое место разработки. В ре- 
зультате многие разработчики, находящиеся в разных местах, могли бы ра- 
ботать над проектом, даже если некоторые из них временно были оффлайн. 


МАСШТАБИРУЕМОСТЬ, СПОСОБНАЯ 
ПОДДЕРЖИВАТЬ ТЫСЯЧИ РАЗРАБОТЧИКОВ 


Недостаточно иметь только распределенную модель разработки. Линус 
знал, что над выпуском каждой версии Глпах трудятся тысячи разработ- 
чиков. Таким образом, любая новая СКВ должен был поддерживать очень 
большое количество разработчиков, независимо от того, работают они над 
одними и теми же или разными частями проекта. Новая СКВ должна быть 
в состоянии надежно интегрировать всю их работу. 


БЫСТРАЯ И ЭФФЕКТИВНАЯ РАБОТА 


Нужно было гарантировать, что новая СКВ быстра и эффективна. Отдель- 
ные операции обновления и операции передачи по сети должны быть очень 
быстрыми. А чтобы сэкономить дисковое пространство и сократить время 
передачи данных по сети, нужно использовать сжатие и методы "дельты". 
Использование распределенной модели вместо централизованной также 
гарантирует, что сетевая задержка не будет препятствовать ежедневной раз- 
работке. 


ПОДДЕРЖКА ЦЕЛОСТНОСТИ И ДОВЕРИЕ 


Поскольку СИ - это распределенная система управления версиями, жиз- 
ненно важно получить уверенность в том, что обеспечивается целостность 
данных, и никто не может внести несанкционированные изменения. Как вы 
узнаете, что данные не были изменены при переходе от одного разработчи- 
ка к другому? Или от одного репозитория к следующему? СИ использует 
общую криптографическую хеш-функцию, названную Зесиге НазВ Еипс- 
Чоп (ЗНА1), для идентификации объектов в базе данных. Данная функция 
гарантирует целостность и доверие для распределенных репозиториев СЁ. 
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ОТСЛЕЖИВАЕМОСТЬ 


Один из ключевых аспектов системы управления позволяет узнать, кто из- 
менил файлы, и, если это возможно, почему. СЁ ведет журнал изменений 
на каждой фиксации, изменяющей файл. Какая именно информация будет 
храниться в журнале, определяется до начала проекта в зависимости от тре- 
бования к проекту, управлению, разных соглашений и т.д. СЁ гарантирует, 
что в ваших файлах не будет загадочных изменений, поскольку он отслежи- 
вает каждое изменение. 


НЕИЗМЕННОСТЬ 


База данных репозитория СЁ содержитобъекты данных, которые являются 
неизменными. После их создания и помещения в базу данных они больше 
не могут быть изменены. Они могут быть воссозданы иначе, конечно, но ис- 
ходные данные не могут быть изменены без последствий. Проект базы дан- 
ных СЕ означает, что вся история, сохраненная в базе данных управления 
версиями, также неизменная. Использование неизменных объектов имеет 
несколько преимуществ, в том числе быстрое сравнение для равенства. 


АТОМАРНЫЕ ТРАНЗАКЦИИ 


При использовании атомарных транзакций много разных, но связанных 
изменений, выполняются вместе или не выполняются вообще. Это гаран- 
тирует, что базу данных управления версиями не оставят в частично изме- 
ненном или поврежденном состоянии при обновлении или фиксации. СЁ 
реализует атомарные транзакции, записывая полные, дискретные состоя- 
ния репозитория, которые не могут быть разделены на отдельные или мень- 
шие изменения состояния. 


ПОДДЕРЖКА И ПООЩРЕНИЕ РАЗВЕТВЛЕНИЯ 
РАЗРАБОТКИ 


Почти все СКВ могут поддерживать различные генеалогии разработки в 
единственном проекте. Например, одну последовательность изменений 
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кода можно было вызвать "разработкой", а другую — "тестированием". 
Каждая система управления версиями может также разделить одну линию 
разработки на несколько линий, а затем объединить их в одно целое. СЁ 
называет каждую линию разработки ветвью и назначает каждой ветви соб- 
ственное имя. 


Вместе с ветвлением приходит объединение. Линус хотел не только воз- 
можность ветвления, но и простое объединение те ответвлений. Поскольку 
слияние ответвлений часто было болезненной и трудной работой в систе- 
мах управления версиями, важно поддерживать быстрое и простое слияние. 


ПОЛНЫЕ РЕПОЗИТОРИИ 


Чтобы отдельные разработчики не запрашивали журнал изменений у цен- 
трализованного сервера репозитория, важно, чтобы у каждого репозитория 
была полная копия всех изменений каждого файла. 


21.3. Установка СИ 


Для установки СЁ в Глпих нужно ввести команду: 


зиао аре 1п3%а]11 491 91%-Чос ад1емеь 91-91 а1ЕК 91Е-ета11 
а1е-зуп 


Данная команда установит СЁ в ОеМап-подобном дистрибутиве (ОЪБипёи, 
Киришеа, ОеЫап и т.д.). Если у вас Еедога, то команду арё нужно заменить 


на и} 


зиао апЁ 1п036а]1]1 91 916Е-Чос а16меЬ 91%-9а1 916К 916-ета11 
а1е-зуп 


СК для УЛп4о\$ можно получить по адресу: 


йнрз//вирототаощ$.от/ 
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и устанавливается он как обычное УЛп4до\з-приложение. Подробно описы- 
вать процесс установки нет смысла, так как любой среднестатистический 
Руоп-программист справится с этой задачей. 


21.4. Основы работы с 


Си управляет изменениями. СЁ — одна из систем управления версиями. 
Множество принципов, например, понятие фиксации, журнала изменений, 
репозитария, являются одинаковыми для всех инструментов подобного 
рода. Но СЁ предлагает много новинок. Некоторые понятия и методы дру- 
гих систем управления версиями могут работать по-другому в СЁ или не 
работать вообще. Независимо от наличия вашего опыта работы с подобны- 
ми системами, данная книга учит вас работать с СЁ. 


21.4.1. КОМАНДНАЯ СТРОКА СТ 


Си очень просто использовать. Просто введите =й без всяких аргументов. 
Си выведет свои параметры и наиболее общие подкоманды. 


$ а1Е 

91е [--Уегз1оп] [--ехес-ра®р [=СТТ_ ЕХЕС_РАТН]] 
[-р|--рад1паее|--по-радег] [--Баге] [--91-91хг=СтТТ Отв] 
[--иогк-Егее=СтТТ МОВК ТВЕЕ] [--ре1р] СОММАМЬ [АВС$] 


Далее приведены наиболее часто используемые команды 2й: 


® а44- Добавляет содержимое файла в индекс 

® [615есё - Выполняет бинарный поиск ошибки по истории фиксаций 
® ртапср - Выводит, создает или удаляет ветки 

® сресРош- Проверяет и переключает на ветку 

® спе — Клонирует репозиторий в новый каталог 


® сотти — Записывает изменения в каталог (фиксация) 
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» (}- Показывает изменения между фиксациями, рабочими деревьями 
итд. 


» /е{сй-— Загружает объекты и ссылки из другого репозитория 
® стер - Выводит строки, соответствующие шаблону 


® 1 — Создает пустой репозиторий 5й или переинициализирует суще- 
ствующий 


» [ор- Показывает журналы фиксации 
» тегре — Объединяет две или больше истории разработки 


® 70 — Перемещает или переименовывает файл, каталог или символиче- 
скую ссылку 


» ри/- Получает изменения из удаленного репозитория и объединяет их с 
локальным репозиторием или локальной веткой 


» ризй — Загружает изменения из вашего локального репозитория в уда- 
ленный 


®» теразе — Строит ровную линию фиксаций 

® 7езеё — Сбрасывает текущий НЕАП в указанное состояние 
» 771 Удаляет файлы из рабочего дерева и из индекса 

® 5р0ш — Показывает различные типы объектов 

® 545 — Показывает состояние рабочего дерева 


» (а - Создает, выводит, удаляет или проверяет тег объекта, подписанно- 
гос СРС 


Чтобы вывести полный список подкоманд 2, введите: 


916 Пе1р --а11 


Как видно из подсказки использования, имеется множество полезных оп- 
ций для 2й. Большинство опций, показанных как [АКС$], применяются к 
определенным подкомандам. 


Например, опция --уегз1оп применяется к команде =й и производит вывод 
номера версии: 
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$ 491 --уегз1оп 
91Е уегз1оп 1.8.3.пзузае.0 


А опция --атеп4, наоборот, относится к подкоманде сотти: 


$ а1Е сопт1Е --ащепа 


В некоторых случаях придется указывать обе формы опция, например: 


$ 91 --91Е-А1г=рго]ес®.41Е гераск -а 


Получить справку по каждой подкоманде &й можно следующими способа- 
ми: 


91 Ве1р зиьсомтап, 91% --Ве1р зирсопштапЯ или 91 зибсоптапа 
—-=ре1р 


Раньше у СЁ был набор простых, отличных, автономных команд, разрабо- 
танных согласно философии "Оих {ооЩ!: небольшие и независимые ин- 
струменты. Каждая команда начиналась со строки &й и содержала дефис, 
после которого следовало название выполнимого действия, например, &й- 
соттй и =й-оЕ. Однако на данный момент считается, что должна быть одна 
единственная исполнимая программа =й, а выполняемые действия должны 
передаваться в качестве параметров, например, & соттй и = ог. Нужно 
отметить, что формы команд 2 соттй и Ей-соттй идентичны. 


Примечание. Онлайн-документация по СЁ доступна по адресу 
В рз://титогз.едде.Кегпе!.огд/ри/зоЙмгаге/зст/аН/4ос$/ 


Команды #2й понимают "короткие" и "длинные" команды. Например, следу- 
ющие две команды &й соттй эквиваленты: 


$ а1Е сопм1е -м "Е1хеа а вуро." 


$ 916 сопи1е --меззааде="Е1хеа а фуро." 
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В короткой форме используется один дефис, а длинная форма использует 
два. Некоторые опции существуют только в одной форме. 


Наконец, вы можете разделить параметры из списка аргументов, используя 
"пустое двойное тире". Например, используйте двойное тире, чтобы отде- 
лить часть управления командной строки от списка операндов, например, 
от имен файлов: 


$ а1Е АН -м тазфег ог1а1п -- &001$3/Макей]1е 


Двойное тире нужно использовать, чтобы разделить и явно идентифициро- 
вать имена файлов, если иначе они могли бы быть приняты за другую часть 
команды. Например, если у вас есть тег "та1п.с" и файл "ташт.с", вы полу- 
чите различное поведение: 


# Проверка тега с именем "ма1п.с" 
$ а1Е спескойЕ ма1п.с 

# Проверка файла с именем "та1п.с" 
$ а1Е спескойЕ -- ма1п.с 


21.4.2. БЫСТРОЕ ВВЕДЕНИЕ В С@Т 


Чтобы увидеть #й в действии, давайте создадим новый репозиторий и до- 
бавим в него некоторое содержимое, а после чего сделаем несколько версий 
этого содержимого. 


Существует две фундаментальных техники установки репозитория СИ. 
Вы можете создать его с нуля, а потом заполнить его содержимым, или же 
скопировать, или как говорят в мире Си, склонировать, существующий ре- 
позиторий. Проще начать с пустого репозитория, поэтому давайте сделаем 
это. 


СОЗДАНИЕ НАЧАЛЬНОГО РЕПОЗИТОРИЯ 


Чтобы смоделировать типичную ситуацию, давайте создадим репозиторий 
для вашего персонального сайта в каталоге -/рибс_Бёт|. 
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Если у вас нет вашего личного сайта в -/ри с_Бт|, создайте этот каталог 
и поместите в него файл ш4ех.Бет] с любой строкой: 


$ шкафк -/руб11с_ВЕт1 
.$ са -/рчь11с Вет 
$ есВо 'Мой сайт жив!' > 1паех.Вет1 


Чтобы превратить -/риБИс_Б т] или любой другой каталог в репозиторий 
СТь, просто запустите Ей ий: 


$ 1Е ЧАТЕ 
10161а112е4 ешреу С1Е героз1еогу 1п .91%/ 


Программе дй все равно, начинаете ли вы с полностью пустого каталога или 
с каталога, полного файлов. Процесс преобразования каталога в репозито- 
рий Си будет одинаковым. 


Чтобы отметить, что ваш каталог является репозиторием СЁ, команда Ей 
ти создает скрытый каталог с названием .5&, находящийся на верхнем 
уровне вашего проекта. 


Все остальное в каталоге -/ри Шс_Вт| останется нетронутым. СЁ считает 
этот каталог рабочим каталогом вашего проекта, в котором вы изменяете 
свои файлы. СЁ интересуют только файлы из скрытого каталога .5й. 


ДОБАВЛЕНИЕ ФАЙЛОВ В ВАШ РЕПОЗИТОРИЙ 


Команда Ей тй создает новый репозиторий СЁ. В самом начале каждый ре- 
позиторий СЁ будет пустым. Чтобы управлять контентом, вы должны явно 
добавить его в репозиторий. Такой осознанный файл позволяет разделить 
рабочие файлы от важных файлов. 


Команда 31 ааа <файл> используется для добавления файла <файл> в 
репозиторий: 


$ а1Е ааа 1пдех.В м1 


РУПоп. Полное руководство ОО [с ру{Поп 


Примечание. Если в вашем каталоге есть несколько файлов, 
не нужно добавлять все их вручную, пусть за вас это сделает д#. 
Чтобы добавить в репозиторий все файлы в каталоге и во всех 
подкаталогах, используйте команду 9 а4дЧ . (одна точка в Угих 
означает текущий каталог). 


После добавления файла СИ знает, что файл ш4ехБет принадлежит репо- 
зиторию. Но СЁ просто подготовил файл, это еще не все. В СЁ разделены 
операции добавления и фиксации. Это сделано для лучшей производитель- 
ности — вы только представьте, сколько времени займет обновление репози- 
тория при каждом добавлении или удалении файла. Вместо этого СЁ пред- 
лагает раздельные операции, что особенно удобно в пакетном режиме. 


Команда 2й 5 ай покажет промежуточное состояние файла 1п4дех.Вет: 


$ 91Е зЕабаз 
Оп БгапсЬ мазфек 


10161а1 сопт1е 


# 
# 
# 
# 
# Свапдез фо Бе сома Еееа: 

# (азе "91 гм --сасреа <В1е>..." о опзфаде) 

# 

# пем Н1е: 1пдех.5еи1 

Данная команда сообщает, что при следующей фиксации в репозиторий бу- 
дет добавлен новый файл ш4ех.Бет|. 


Помимо актуальных изменений в каталоге и его файлах при каждой фикса- 
ции СЕ записывает различные метаданные, включая сообщение журнала и 
автора изменения. Полная команда фиксации выглядит так: 


$ а1Е сопи1Е -ш "Начальное содержимое руб11с_Ве1" 
—--апВог="Доп Тое11дег <)91@ехапр1е.сом>" 

СгеафеЯ 1п141а1 сомм1е 99а5814: 1п111а1 сопёепЕ5 оЁ ричЮ11с_ 
В Ет1 

1 ВШез срапдеа, 1 1п5егЕ1оп$ (+), 0 ае1ее1опз (-) 

сгеафе мое 100644 1паех.Вем1 


Вы можете предоставить сообщение журнала из командной строки, но 
обычно удобнее создать его с помощью интерактивного текстового редак- 
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тора. Чтобы СЁ открывал ваш любимый текстовый редактор при фиксации 
изменений, установите переменную окружения СТТ_ЕБТТОВК: 


$ В Есзв 

$ зефепу СТТ ЕОТТОВ етас$ 
$ В Базв 

$ ехрогЕ СТТ ЕОТТОВ=УИа 


Послефиксации добавления нового файла в репозиторий, команда &й 5аи5 
покажет, что нет ничего, что требовало ли фиксации: 


$ 91Е зЕаеаз 
# Оп БЬгапср мазеех 
поЕВ1па во сошп1Е (могКк1па Ч1гес®огу с1еап} 


СК также сообщает вам, что ваш рабочий каталог чист. А это означает, что в 
вашем рабочем каталоге нет неизвестных или измененных файлов, которые 
отличаются от тех, которые находятся в репозитории. 


НЕЯСНЫЕ СООБЩЕНИЯ ОБ ОШИБКАХ 


СИ пытается определить автора каждого изменения. Если вы не сконфигу- 
рировали свое имя и е-та! так, чтобы они были доступны в СК, это может 
стать причиной некоторых предупреждений. Но не нужно паниковать, ког- 
да вы видите примерно такие сообщения: 


Уоц Чаоп'Е ех13е. Со амау! 
Уоцг рагепёз тмазЕ Вахе Бафе4 уо\! 
Уоцг зузаат1тп мшазЕ Вафбе уо\ц! 


Они просто означают, что СЁ не может определить ваше реальное имя по 
какой-то причине. Проблема может быть исправлена путем установки ва- 
шего имени и е-тай, что будет показано в разделе "Настройка автора 
фиксации". 


РУпоп. Полное руководство ©) руВоп 


НАСТРОЙКА АВТОРА ФИКСАЦИИ 


Перед фиксацией вам нужно установить некоторые параметры конфигура- 
ции и переменные окружения. Как минимум, СЁ должен знать ваше имя и 
ваш е-тай. Вы можете указывать эти данные при каждой команде фикса- 
ции (2й соттй), как было показано ранее, но это очень неудобно. Вместо 
этого лучше всего сохранить данную информацию в файле конфигурации, 
используя команду #й сопрр: 


$ а1Е сопйа азег.паме "Фоп 1ое11дег" 
$ а91Е сопНа изег.ета11 ")]91@ехапр1е .сом" 


Вы также можете сообщить Си свое имя и свой е-та!, установив перемен- 
ные окружения СТТ_АОТНОК_МАМЕ и СМТ_АОТНОК_ЕМАП.. Если 
эти переменные окружения установлены, они перезапишут все параметры, 
установленные в файле конфигурации. 


ВНОСИМ ДРУГУЮ ФИКСАЦИЮ 


Чтобы продемонстрировать еще несколько функций СК давайте внесем не- 
которые изменения и создадим сложную историю изменений внутри репо- 
зитория. 


Откройте шдех№Вт1|, конвертируйте его в НТМТ, сохраните изменения и 
выполните фиксацию изменений: 


$ са -/раь11с ре1 
# редактируем 1паех.пЕт1 


$ саё 1паех.ВЕт1 
<ВЕи1> 

<роау> 

Мой сайт жив! 
</Боау> 

</вЕт1> 


$ 91Е сопи1е 1паех.6Еп1 
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Когда откроется редактор, введите описание фиксации, например, "Файл 
конвертирован в НТМГ". После чего в репозитории появится две версии 
файла тш4ех.Вит. 


ПРОСМОТР ВАШИХ ФИКСАЦИЙ 


Как только в вашем репозитории появилось несколько фиксаций, вы мо- 
жете исследовать их различными способами. Некоторые команды СЁ по- 
казывают последовательность отдельных фиксаций, другие — сводку об от- 
дельной фиксации, а остальные показывают полную информацию о любой 
фиксации в каталоге. 


Команда &й [оЕ показывает историю отдельных фиксаций в репозитории: 


$ а1Е 10а 

сопи1 ес232сааЕЬ94е0аЕ9555855аЁ8аеа7Е5е р 5с90а6 
АпЕрог: Фоп Гое11дег <)41@ехапр1е.сом> 

Рафе: Меа Арг 2 16:47:42 2008 -0500 


Файл конвертирован в НТМЬ 


сопт1 94а5814910с9с4ас93557са4859е767Е5саЕ 5169 
АпЕрог: Фоп Гое11дег <)41@ехапр1е .сом> 
Рафе: Тра Маг 13 22:38:13 2008 -0500 


Начальное содержимое риЮ11с_рВ&п1 


Записи выводятся в порядке от самой последней до самой старой. Каждая 
запись показывает имя и е-та! автора фиксации, дату фиксации и сообще- 
ние, добавленное в журнал при фиксации. 


Для получения более подробной информации о конкретной фиксации, ис- 
пользуйте команду й 5йош: 


$ а1Е зром 94а581а910с9с4ас93557са4859е767Е5саЕ 5169 
сомп1Е 94а58149910с9с4а693557са4859е767Е5саЕ 5169 
АпЕерог: Фоп Ёое11дег <)41@ехапр1е.сощ> 

Рафе: Тра Мах 13 22:38:13 2008 -0500 

11161а1 сопеепез оЁ рую11с В&и1 


а1Н --91Е а/1паех.рЕт1 Ь/1паех.ВЕт1 
пем Н1е поае 100644 

1раех 0000000. .34217е9 

--- /аеу/йи11 

+++ 5/1паех.Вем1 

@@ -0,0 +1 @@ 


+Мой сайт жив! 


Если вы запустите 2й зпош без указания идентификатора фиксации, вы по- 
лучите информацию о последней фиксации. 


Другая команда, зйош-Бтапсй, выводит краткую сводку для текущей ветки 
разработки: 


$ а1Е зром-Бгапср --тоге=10 
[пазфег] Файл конвертирован в НТМЫ 
[пазсег^] Начальное содержимое рир11с рёпт1 


Параметр --тоге=10 указывает, что нужно вывести не более 10 версий, но в 
нашем случае пока существуют только две версии. Имя тает - это имя по 
умолчанию для ветки. 


ПРОСМОТР РАЗНИЦЫ МЕЖДУ ФИКСАЦИЯМИ 


Чтобы увидеть разницу между двумя версиями 1п4ех.Б |, вам понадобятся 
идентификаторы этих двух фиксаций, которые нужно передать команде #й 


@&} 


$ а1Е а1Н 99а5819910с9с4ас93557са4859е767Е5са#5169 \ 
ес232сааЕЬ94е09Е9555855аЁЕ8 аеа7Е5еб5с90а6 
а1Н --91Е а/1паех.Вт1 Ъ/1паех.ВЕм1 
1паех 34217е9..8638631 100644 

--- а/1паех.Вет1 

+++ Б/1паех. В ем1 

@@ -1 +1,5 @@ 

+<р 1 > 

+<Боау> 

Мой сайт жив! 

+</рБоау> 
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+</6т1> 


Этот вывод должен выглядеть знакомым. Он напоминает вывод команды 
@&}. Первая версия, 94а5814910с9с4ас93557са4859е767са51 69, является 
более ранней версией содержимого, а версия с именем ес232с44594е04 45 
Ь5855а#84е4745е65с9046 является более новой. Таким образом, знак "плюс" 
(+) предшествует каждой строке нового содержимого. 


Вы испугались, глядя на эти шестнадцатеричные идентификаторы? Не 
волнуйтесь, СИ предлагает более лаконичные способы идентифицировать 
фиксации без необходимости указания таких сложных чисел. 


УДАЛЕНИЕ И ПЕРЕИМЕНОВАНИЕ ФАЙЛОВ В ВАШЕМ 
РЕПОЗИТОРИИ 


Удаление файла из репозитории аналогично добавлению файла, но вместо 
команды 8й ааа используется команда 2й тт. Представим, что в нашем ката- 
логе веб-сайта есть файл роет.Бт1, который больше не нужен. 


$ са -/рчр11с_рт1 
$ 18 
1паех.В%п1 роем.Вт1 


$ а1Е гм роем.Вем1 
ги 'роем.Вт1' 


$ 91Е соми1е -м "Удаляем поэму" 

СгеафеЯ сошм1е 364а708: Удаляем поэму 

0 Н1ез срараеа, 0 1пзегЕ1опз (+), 0 ае1ее1опз (-) 
Аае1ефе поае 100644 роет.В&т1 


Как и добавление, удаление состоит из двух этапов. Сначала &й тт удаляет 
файл из репозитория, а затем &й сотти фиксирует изменения в репозито- 
рии. Опция -т позволяет указать описание фиксации, например, "Удаляем 
поэму". Вы можете опустить эту опцию, чтобы задать сообщение в вашем 
любимом текстовом редакторе. 


Для переименования файла можно использовать комбинацию #й 7т и Ей 
а44 или же, что намного быстрее, использовать команду Ей то: 
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$ шу Еоо.Вет1 Баг.В®м1 
$ 91Е га Еоо.ВЕт1 

ги 'Еоо.Беш1' 

$ а1Е ааа Баг. Вем1 


В данном случае мы сначала переименовываем файл юо.Виш в Баг. и 
удаляем файл юо.Вит|, как из репозитория, так и с файловой системы, по- 
сле чего добавляем файл Баг. ет] в репозиторий. 


Эту же операцию можно выполнить с помощью одной команды: 


$ а91Е шу Еоо.В®м1 Баг.Вем1 


После всего этого нам нужно фиксировать изменения: 


$ а91Е сопм1Е -м "Переименование Еоо в Баг" 
СгеафеЯ сопи1е 8805821: Переименование Гоо в Баг 
1 Шез свападеа, 0 1пзегЕ1оп$ (+), 0 де1ее1опз (-) 
гепаме ЁЕоо.рЕтТ => Баг.Б®т1 (100%) 


Ск обрабатывает операции перемещения файла иначе, чем другие систе- 
мы, используя механизм, основанный на базе подобия содержания между 
двумя версиями файлов. 


КОПИРОВАНИЕ ВАШЕГО РЕПОЗИТОРИЯ 


Ранее мы создали наш начальный репозиторий в каталоге -/рибИс_ Бет]. 
Теперь мы можем создать полную копию (или клон) этого репозитория ко- 
мандой 2 с/опе. 


Сейчас мы создадим копию нашего репозитория в нашем домашнем катало- 
ге, она будет называться ту_\мезКе: 


$4 = 
$ 91Е с1опе риб11с Вет шу мерз1%е 
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Хотя эти два репозитория СЁ теперь содержат те же объекты, файлы и ка- 
талоги, есть некоторые тонкие различия. Исследовать эти различия можно 
командами: 


$ 15 -15а руб11с В1 му_меб51®е 
$ а1Н -г руь11с В1 му мебз1е 


На локальной файловой системе, подобно этой, использование 2 сопе соз- 
даст копию репозитория подобно командам ср -а или гзупс. Однако СЁ под- 
держивает богатый набор любых других источников, в том числе сетевые 
репозитории. 


Как только вы клонируете репозиторий, вы сможете изменять, делать но- 
вые фиксации, исследовать журналы и историю и т.д. Это полностью новый 
репозиторий со своей полной историей. 


ФАЙЛЫ КОНФИГУРАЦИИ 


Конфигурационные файлы СЁ - это простые текстовые файлы в стиле Н11- 
файлов. В них записываются различные установки, используемые многими 
Си-командами. Некоторые установки представляю собой сугубо личные 
предпочтения (например, со]ог.раёег), другие жизненно важны для пра- 
вильного функционирования репозитория (соге.герозКогуюгта&уег$1юп), а 
остальные управляют поведением команд (например, 5с.аио). 


‚Подобно многим другим утилитам СИ поддерживает иерархию конфигура- 
ционных файлов. В порядке уменьшения приоритета приведены его конфи- 
гурационные файлы: 


® БК/сопйё — специфичные для репозитория параметры конфигурации, 
которыми управляет опция --Не. У этих настроек наивысший приоритет. 


® -/.бКсопйБ — специфичные для пользователя параметры конфигурации, 
которыми управляет опция --2]оБа|. 


® /в{с/ЕЦсопй& — системные параметры конфигурации, изменить которые 
можно опцией --зузбет, если у вас есть надлежащие права доступа Чшх 
(нужно право на запись этого файла). Данные настройки обладают наи- 
меньшим приоритетом. 
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В зависимости от вашей инсталляции, системные настройки могут быть 
где-то еще, возможно, в /изг/1оса|/ес/сопЯ», или могут полностью отсут- 
ствовать. 


Например, для установки имени и е-та! пользователя, произведшего фик- 
сацию, нужно указать значения параметров изег.пате и изег.ета! в вашем 
файле$НОМЕ/.=(сопйв. Для этого используется команда 2 сопйе --=офа|: 


$ 91Е сопНа --91ора1 изег.паме "Фоп 1ое11дех" 
$ 91Е сопНа --91ора1 изег.ета11 ")а1@ехамр1е.сом" 


Можно установить специфичные для репозитория имя пользователя и 
адрес электронной почты, которые переопределят глобальные установки, 
для этого просто опустите флаг --]оБа[: 


$ 91Е сопНа изег.паме "Фоп Гое11дег" 
$ а1Е сопйа изег.ета11 ")91@5рес1а1-рго]ес®.ехатр1е.ога" 


Используйте 2 сопйв -1| для вывода всех переменных, найденных во всем 
наборе файлов конфигурации: 


# Создаем пустой репозиторий 
$ шКка1к /Емр/пем 

$ са /епр/пеи 

9 а1Е ЗЕ 


# Устанавливаем некоторые переменные 

$ 91Е сопНа --91ора1 изег.паме "Фоп Гое11дег" 

$ 91Е сопНа --91ора1 изег.ета11 ")а1@ехапр1е.сом" 

$ а1Е сопйа изег.етма11 ")91@5рес1а1-рго)ес®е.ехатр1е.ога" 


$ а1Е сопНа -1 

изег.паме=Фоп Гое11дех 

и5ех .ема11=)а1@ехапр1е.сом 

соге .геро$1огуЕогма®уег$1оп=0 
соге.Н1етоае=е гие 

соге.Раге=Ёа1зе 

соге.1ода11хеЕирЧ4афез = гае 
изег.ета11=)491@зрес1а1-рго)ес®.ехатр1е.ога 
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Поскольку файлы конфигурации — это обычные текстовые файлы, вы мо- 
жете просмотреть их содержимое командой сай и отредактировать в люби- 
мом текстовом редакторе: 


$ Посмотрим на параметры репозитария 

$ саЕё .91е/сопНа 

[соге] 

героз1$огуЕогта уегз1оп = 0 

Н1етоае = +гие 

Баге = Еа1зе 

1ода11геЕарЧ4аеез = $ гие 

[пзег] 

ета11 = )491@зрес1а1-рго]ес*.ехапр1е.ога 


Или, если вы используете ОС от М!сгозо&, у вас будут некоторые измене- 
ния. Скорее всего, ваш конфигурационный файл будет выглядеть примерно 
так: 


[соге] 

героз1$огуЕогта$ уегз1оп = 0 
Б1етоае = Егиае 

Баге = Егае 
1ода11хеЕорааеез = $гие 
зум]11пК$ = Еа1зе 

1апогесазе = +гае 
В1аероЕЕ11ез = 40о%С1Е001у 


Большинство из этих изменений - из-за разницы в характеристиках файло- 
вой системы. Отключены символические ссылки, включено игнорирование 
регистра символов, другие настройки для скрытых файлов. 


Используйте опцию --ипзей для удаления настройки: 


$ 91Е соп—Нд --ипзеё --91ора1 изег.ета11 


Поведение команды &й сопйя изменено между версиями 1.6.2 и 1.6.3. Бо- 
лее ранние версии потребовали, чтобы после опции --ипзеё следовала опция 
--]оБа1. В новых версиях допустим любой порядок. 


Рупоп. Полное руководство ООО в, руЕпоп 


Для одной и той же цели существуют несколько параметров конфигурации 
и переменных окружения. Например, редактор, который будет вызван при 
создании сообщения журнала фиксации, можно задать с помощью: 


® Переменной окружения СТТ_ЕПТТОКВ 
» Опции конфигурации соге.еЧ ог 

» Переменной окружения У1З0АТ. 

е Переменной окружения ЕПТТС 


® Команды \ 


Есть несколько сотен параметров конфигурации. По мере чтения книги я 
буду обращать ваше внимание на самые важные из них. На странице руко- 
водства (тшап) по команде дй сопйЕ вы найдете более подробный (и все жене 
полный) список параметров конфигурации 


НАСТРОЙКА ПСЕВДОНИМОВ 


Новичкам пригодится совет по настройке псевдонимов командной строки. 
Часто команды СЕ ДОВОЛЬНО сложны, ПОЭТОМУ ДЛЯ самых часто использу- 
емых команд вы можете создать псевдонимы: 


$ 91Е соп—На --91ора1 а11аз.зВом-акарв \ 
']1од --дгарВ --абргеу-сошм1е --ргеефу=опе11пе' 


В этом примере я создал псевдоним зВо\/-вгарЬ и сделал его доступным в 
любом созданном мной репозитории. Теперь, когда я использую команду 
ЕЙ зрош-Етарй будет выполнена длинная команда 2 [од со всеми заданными 
ОПЦИЯМИ. 


21.5. Основные понятия СИ 


В предыдущем разделе было рассмотрено типичное применение Ск. Ско- 
рее всего, после ее прочтения у вас появилось гораздо больше вопросов, 
чем было до того. Какие данные Си хранит для каждой фиксации? Каково 


в рут Глава 21. Контроль кода 


назначение каталога .5? Почему Г) фиксации напоминает мусор? Нужно 
ли мне обращать внимание на него? 


Если вы использовали другую СКВ, например, ЗУМ или СУ5, команды, 
представленные ранее, наверняка покажутся вам знакомыми. На самом 
деле, СИ служит для той же цели и предоставляет все операции, которые вы 
ожидаете увидеть в современной СКВ. Однако, СЁ некоторые понятия С 
отличаются, о чем мы и поговорим. 


Сейчас мы выясним, чем отличается СК от других СКВ, исследуя ключевые 
компоненты его архитектуры и некоторые важные понятия. 


21.5.1. РЕПОЗИТОРИИ 


Репозиторий СЁ -— просто база данных, содержащая всю информацию, 
необходимую для управления версиями и историей проекта. В Ск, как и 
в большинстве других систем управления версиями, репозиторий хранит 
полную копию всего проекта на протяжении всей его жизни. Однако, в от- 
личие от большинства других УС$, репозиторий СЁ не только предостав- 
ляет полную рабочую копию всех файлов в репозитории, но также и копию 
самого репозитория, с которым работает. 


В каждом репозитории СЁ обслуживает ряд значений конфигурации. Вы 
уже видели некоторые из них (имя пользователя и его е-та!|) ранее. В отли- 
чие от данных файла и других метаданных репозитория, параметры конфи- 
гурации не переходят из одного репозитория в другой при клонировании. 
Вместо этого СЁ исследует конфигурацию и информацию об установке на 
основе пользователя, сайта, репозитория. 


В репозитории СЁ управляет двумя основными структурами данных - хра- 
нилищем объектов и индексом. Все эти данные репозитория хранятся в 
корне вашего рабочего каталога в скрытом подкаталоге с именем .5(. 


Хранилище объектов разработано для эффективного копирования при опе- 
рации клонирования как часть механизма, полностью поддерживающего 
распределенный УС$. Индекс - это переходная информация, персональная 
для репозитория. Индекс может быть создан или изменен по требованию в 
случае необходимости. 


В следующих двух разделах подробно рассмотрены хранилище объектов и 
индекс. 


Рупоп. Полное руководство МО 2. ру*Воп 


21.5.2. ТИПЫ ОБЪЕКТОВ СТ 


Сердце репозитория СЁ - это хранилище объектов. Оно содержит ваши 
исходные файлы и все сообщения журналов, информацию об авторе, даты 
и другую информацию, необходимые для сборки любой версии или ветки 
проекта. 


В хранилище объектов СЁ помещает объекты четырех типов: блобы (от 
англ. ВГОВ, Втагу Гатее ОБес!), деревья, фиксации и теги. 


БЛОБЫ 


Каждая версия файла представлена как ВГОВ. ВТОВ - это аббревиатура 
для "Втату Гатее ОБесЕ", то есть большой двоичный объект. Этот термин 
часто используется в информатике для обозначения некоторой переменной 
или файла, которая (который) может содержать любые данные и внутрен- 
няя структура которой (которого) игнорируется программой. Блоб содер- 
жит данные файлы, но не содержит какие-либо метаданные о файле, даже 
его имя. 


ДЕРЕВЬЯ 


Дерево представляет один уровень информации каталога. Оно записыва- 
ет идентификаторы блобов, имена путей и немного метаданных для всех 
файлов в каталоге. Оно также может рекурсивно ссылаться на другие под- 
деревья. Деревья используются для построения полной иерархии файлов и 
подкаталогов. 


21.5.3. ФИКСАЦИИ 


Объекты фиксации хранят метаданные для каждого изменения, произо- 
шедшего в репозитории, включая имя автора, дату фиксации И сообщение 
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журнала. Каждая фиксация указывает на объект дерева, который захваты- 
вает в одном полном снимке состояние репозитория на момент осущест- 
вления фиксации. У начальной (корневой) фиксации нет родителя. У 
большинства обычных фиксаций есть одна родительская фиксация, хотя 
фиксация может ссылаться на несколько родительских фиксаций. 


ТЕГИ 


Объект тега назначает человекочитаемое имя определенному объекту, 
обычно фиксации. Хотя 94а5814910с9с4ас93557са4859е7675са 5169 по- 
зволяет точно идентифицировать фиксацию, для человека более удобным 
идентификатором является что-то вроде Уег-1.0-А]рва. 


Со временем вся информация в хранилище объектов изменяется и растет, 
отслеживая и моделируя ваши правки проекта, добавления и удаления фай- 
лов. Чтобы эффективно использовать дисковое пространство и пропускную 
способность, СЁ сжимает объекты в расК-файлы, которые также помещают- 
ся в хранилище объектов: 


21.5.4. ИНДЕКС 


Индекс - временный и динамический двоичный файл, который описывает 
структуру каталогов всего репозитория. В частности, индекс получает вер- 
сию полной структуры проекта в некоторый момент времени. Состояние 
проекта может быть представлено фиксацией и деревом. 


Одна из ключевых отличительных функций СЦ - то, что он позволяет вам 
изменить содержание индекса четко определенными действиями. Индекс 
позволяет разделение между шагами поэтапной разработки и поддержкой 
тех изменений. 


Вот как это работает. Как разработчик, вы выполняете команды СЦ, чтобы 
подготовить изменения в индексе. Изменения обычно включают добавле- 
ние, удаление или редактирование файлов. Индекс записывает эти измене- 
ния и хранит их, пока вы не зафиксируете их. Вы можете также удалить или 
заменить изменения в индексе. Таким образом, индекс — это как мост между 
двумя сложными состояниями репозитория. 


21.5.5. АССОЦИАТИВНЫЕ ИМЕНА 


Хранилище объектов СЁ организовано и реализовано как ассоциативная 
система хранения. В частности, каждому объекту в хранилище присваи- 
вается уникальное имя, применяя алгоритм ЗНА1 к содержанию объекта, 


что приводит к значению хэш-функции 5$НА1. Поскольку значение хэш- 
функции вычисляется на основании содержания объекта, полагают, что оно 
уникально для определенного содержания. Следовательно, у каждого объ- 
екта будет уникальное имя в базе объектов. Крошечное изменение в файле 
приведет к изменению хэша ЗНА1, в итоге новая версия файла будет индек- 
сироваться отдельно. 


Значения ЗНА1 - 160-разрядные значения, которые обычно представляют- 
ся как 40-разрядное шестнадцатеричное число, такое как 94а58194910с9с4ас 
93557са4859е767Ё5са! 5169. Иногда во время отображения значения ЗНА1 
сокращаются до меньшего уникального префикса. Пользователи СЁ назы- 
вают эти числа ЗНА1, хэш-код и идентификатор объекта — все эти понятия 
взаимозаменяемы. 


21.5.6. ГЛОБАЛЬНО УНИКАЛЬНЫЕ 
ИДЕНТИФИКАТОРЫ 


Важная характеристика вычисления хеша ЗНА1 - то, что он всегда вычис- 
ляет тот же’ Ш для идентичного содержания, независимо от того, где это 
содержание находится. Другими словами, одно и то же содержание файла 
в разных каталогах и даже на разных машинах даст одно и то же значение 
хэша ЗНА1. Таким образом, идентификатор ЗНА1 - это глобально уни- 
кальный идентификатор. 


Благодаря глобально уникальным идентификаторам мы можем через Ин- 
тернет сравнивать блобы или файлы произвольного размера путем про- 
стого сравнения их идентификаторов. Нам не нужно пересылать файлы по 
сети, чтобы определить, идентичны ли они. 


21.5.7. СТ ОТСЛЕЖИВАЕТ КОНТЕНТ 


СИ - это нечто больше, чем просто СКВ. СЁ - это система отслеживания 
контента. Отслеживания контента в СЁ реализовано двумя способами, 
которые существенно отличаются от почти всех других систем управления 
версиями. 


Во-первых, хранилище объектов СЁ основано на вычислении хэша содер- 
жимого объекта, а не на имени файла или каталога. Таким образом, когда 
Си помещает файл в хранилище, он это делает на основании данных хэша, а 
не на основании имени файла. Фактически, Си вообще не отслеживает име- 
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на файлов и каталогов, которые связаны с файлами вторичными способами. 
С вместо имен файлов отслеживает их содержимое. 


Если у двух отдельных файлов есть одинаковое содержание, независимо от 
того, хранятся ли они в одном каталоге или разным, СИ хранит только одну 
копию этого содержания в виде блоба в хранилище объекта. СИ вычисляет 
хэш-код каждого файла исключительно по его содержанию. Оба файла в 
проекте с одинаковым содержанием, независимо от того, где они располо- 
жены, используют один и тот же объект содержания (блоб). 


Если один из этих двух файлов будет изменен, СЁ вычислит новый хэш 
ЗНА1 для него и добавит новый блоб в хранилище объектов. Исходный 
блоб останется в хранилище и будет использован для файла, который 
остался без изменений. 


Во-вторых, внутренняя база данных СЁ хранит каждую версию каждого 
файла, а не разницу между ними. Поскольку СЁ использует хеш полного 
содержания файла как имя для этого файла, он должен оперировать с пол- 
ной копией файла. Он не может основывать свою работу на части содержа- 
ния файла или на разнице между версиями файла. 


Типичное пользовательское представление файла в виде версий и изме- 
нений между версиями является обычным артефактом. СИ вычисляет эту 
историю как ряд изменений между различными блобами вместо того, чтобы 
хранить имя файла и набор различий между версиями. 


21.5.8. ПУТЬ ПО СРАВНЕНИЮ С СОДЕРЖАНИЕМ 


Как и в случае с другими СКВ, СЁ должен вести явный список файлов, ко- 
торые формируют содержание репозитория. Однако это не требует, чтобы 
внутренне СЁ основывался на именах файлов. Действительно, СЁ обраба- 
тывает имя файла только как часть данные, которые отличны от содержа: 
ния этого файла. В резульгате индекс отделяется от данных в традицион- 
ном смысле базы данных. Посмотрите на таблицу 21.1, которая сравнивает 
СИ с другими известными системами. 


Рупоп. Полное руководство ль на (её) ру{ПВоп 


Таблица 21.1. Сравнение баз данных 


Система Механизм индекса Хранилище данных 


Индексно-Последова- 
данных тельный Метод Доступа | Записи данных 
(ЗАМ) 


Традиционная база 


Файловая система | Каталоги (/путь/к/фай- 


190.4 лу) Блоки данных 


.5/оБесёз/БазЬ, содержи- | Объекты блоб, объек- 
мое объекта дерева ты дерева 


Названия файлов и каталогов происходят от базовой файловой системы, но 
Си действительно не заботится об именах. Он просто записывает каждый 
путь и удостоверяется, что он может точно воспроизвести файлы и катало- 
ги из содержимого, которое индексировано значением хэша. 


Физический формат данных не моделируется после пользовательской 
структуры каталога. Вместо этого есть абсолютно другая структура, кото- 
рая может, тем не менее, воспроизвести оригинальную разметку пользова- 
теля. Внутренняя структура СЁ - более эффективная структура данных 
для своих собственных внутренних операций и средств хранения. 


Когда СЕ нужно создать рабочий каталог, он говорит файловой системе: 
"Привет! У меня есть большой блоб данных, которые я хочу поместить в 
файл с именем /каталог/файл. Сделай это как посчитаешь нужным". Начто 
файловая система отвечает: "Я распознала строку, являющуюся набором 
имен подкаталогов, и я знаю, куда поместить твои блоб- данные! Спасибо!". 


21.5.9. РАСК-ФАЙЛЫ 


Проницательный читатель может заметить: "Очень неэффективно хранить 
полное содержимое каждой версии каждого файла. Даже если содержимое 
сжато, все равно неэффективно хранить содержимое разных версий каждо- 
го файла. Почему, если добавляется всего одна строка в файл, СИ сохраняет 
полное содержимое файла?". 
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Давайте попробуем разобраться. СЁ использует очень эффективный ме- 
ханизм хранения, называемый раск-файлом. Для создания упакованного 
файла СЁ сначала определяет местоположение файлов, содержание кото- 
рых очень подобно и хранит полное содержание для одного из них. Затем он 
вычисляет различия или дельты между подобными файлы и хранит просто 
различия. Например, если вам нужно просто изменить или добавить одну 
строку в файл, СЁ может сохранить полную, более новую версия файла и 
затем записать изменение одной строки как дельта и тоже сохранить ее в 
пакете. 


Хранение полной версии файла и дельг, необходимых для создания других 
версий подобных файлов -— далеко не новый прием. Это, по существу, тот же 
механизм, которые другие УС$, такие как КС$, использовали на протяже- 
нии многих десятилетий. 


Си очень умно упаковывает файл. Поскольку СЁ основывается на контен- 
те файла, ему действительно все равно, принадлежат ли дельты, которые 
он вычисляет между двумя файлами двум версиям одного и того же фай- 
ла или нет. То есть СЁ может взять два любых файла и вычислить дельты 
между ними, если он считает, что они могли бы быть достаточно подобны- 
ми, чтобы быть хорошо сжатыми. Таким образом, СЁ обладает тщательно 
продуманным алгоритмом, чтобы найти потенциальных кандидатов дельты 
по всему репозиторию. 


Упакованные файлы хранятся в хранилище объектов вместе с другими 
объектами. Они также используются для передачи данных репозитория по 
сети. 


21.5.10. ПОНЯТИЯ СП В ДЕЙСТВИИ 


Теперь, когда вы знакомы с некоторыми понятиями, давайте посмотрим, 


как они работают в самом репозитории. Давайте создадим новый репозито- 
рий и посмотрим на него внутренние файлы. 


ВНУТРИ КАТАЛОГА „СТ 


Для начала инициализируем пустой репозиторий, используя &й ти, а затем 
запустим команду Да, чтобы посмотреть, что же было создано. 


РУНоп. Полное руководство о [1 русвоп 


$ шКа1г /Емр/Бе11о 

$ са /емр/ве11о 

$ аа затЕ 

10161а11хеа ешреу С16 героз1еогу 1п /&тр/Бе11о/.318/ 


# Выводим все файлы в текущем каталоге 
$ Ноа 


.Ч1Е 

.91Е/Боокз 
.91Е/БооКк$з/сопт1-тз9.залр1е 
.91Е/Боок$/арр1ураЕсв-мза. затр1е 
.91Е/роокз/рге-арр1ура&сВ.затр1е 
.91Е/Воокз/розЕ-сопт1е. затр1е 
.91Е/Боок$/рге-геразе. запр1е 
.91Е/Боокз/розЕ-гесе1уе.затр1е 
.941Е/Боокз/ргераге-сопт1*-тз4.затр1е 
.91Е/Боокз/розЕ-прааке. затр1е 
.91&/Боокз/рге-сомм1е.затр1е 
.91Е/Боокз/ирда*е. затр1е 
.916/геЕз 

.916/геёз/реа@а$ 

.91Е/геЁз/садз 

.91Е/сопйа 

.91Е/оБ)есез 

.916/оБ]есЕз/раск 
„.а1Е/о6)есез/40Ео 
.91Е/аезсг1ре1оп 

.91Е/НЕАО 

.91Е/БгапсВез 

.91Е/10Ео 

.916/10Ео/ехс1оае 


2 > 


Как видите, в каталоге .5й много чего есть. Файлы, выведенные на экран, 


основаны на каталоге шаблона, который вы можете при желании изменить. 
В зависимости от используемой версии СЁ содержимое этого каталога мо- 
жет немного изменяться. Например, более старые версии СЁ добавляют 
"расширение" затр/е к файлам в каталоге .5/Боок$. 


В целом, вам не нужно ни просматривать, ни управлять файлами из ка- 
талога .2й. Эти "скрытые" файлы считаются частью инфраструктуры или 
конфигурации СЁ. Конечно, в СЁ есть набор команд по управлению этими 
скрытыми файлами, но вы будете редко их использовать. 
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Изначально каталог .2/оБ]есё$ (каталог для всех объектов СЁ) пуст, за 
исключением нескольких заполнителей: 

$ Нпа .91е/оБЗесез 

.916/оБ]есез 

.91Е/ою)есез/раск 

.916/о5)]ес+з/1пЁо 


Теперь давайте осторожно создадим простой объект: 


$ есро "ре11о мог1а" > рВе11о.ЕхЕ 
$ 91Е ааа ве11о.&хЕ 


Если вы введете "БеПо мог" точно так же (без изменений в регистре сим- 
волов или интервале между ними), ваш каталог объектов будет выглядеть 
примерно так: 


$ Нпа .91&/оБ)есез 

.916/ою)есез 

.91%/об]есёз/раск 

.916/ою)есЕз/ЗЬ 
.915/ою)есЕз/3Ъ/18е51245а79е4с83004908аеь37Е8е728Ъ8 ааа 
.91Е/ою)есЕз/1пЕо 


Все это выглядит довольно таинственным. Но на самом деле все просто и в 
следующем разделе вы поймете почему. 


ОБЪЕКТЫ, ХЭШИ, БЛОБЫ 


Когда СИ создает объект для БеПо.хе, он не беспокоится об имени файла 
Бео.схе. Его интересует только то, что в файле: последовательность из 12 
байтов — строка "Бе{о мо" и символ новой строки. СЁ. выполняет не- 
сколько операций на этом блобе, вычисляет его хеш ЗНА1 и помещает в 
хранилище объектов как файл, в качестве имени файла используется вы- 
численное значение хэша. 


Хэш в этом случае - 3618е5124Ба79е4с83004408аеь37{8е728Ъ8дач. 160 би- 
тов хэша ЗНА1 соответствуют 20 байтам, а при отображении на экране в 
шестнадцатеричном виде - 40 байтов. Итак, наш контент сохранен как .5/ 
оБесёз/3Ъ/18е5124Ба79е4с830044908аеБ37{8е728Ъ8да4. 


СК вставляет / после первых двух разрядов, чтобы повысить эффектив- 
ность файловой системы. Производительность некоторых файловых си- 
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стем заметно падает, если поместить в один каталог слишком много файлов. 
А если превратит первый ЗНА1 байт в каталог, то это самый простой способ 
создать фиксированное разделение пространства имен для всех возможных 
объектов с равным распределением. 


Чтобы показать, что СЁ действительно ничего не сделал с содержанием 
файла (это все еще строка "ве]о мо"), вы можете использовать хэш фай- 
ла, чтобы получить доступ к содержимому в любой момент: 


$ 91Е сае-Н1е -р 3618е5124аЪа79е4с830049408аеь37Е8е728Ъ8 даа 
Ве11о мог1а 


Примечание. СЁ также знает, что 40 символов немного риско- 
ванно, чтобы их вводить вручную, поэтому он предоставил ко- 
манду для поиска объектов по префиксу хэша: 


$ 91Е геу-рагзе 3518е512а 
3518е512ара79е4с8300494908аеЪ37Е8е72 858 даа 


ФАЙЛЫ И ДЕРЕВЬЯ 


Теперь, когда блоб "Вео мо" безопасно помещен в хранилище объектов, 
что произошло с его именем файла? Си был бы не очень полезен, если он не 
мог бы найти файлы по имени. 


Как было упомянуто выше, СЁ отслеживает пути файлов через другой вид 
объектов — деревья. Когда вы используете Ей ааа, Си создает объект для 
содержания каждого добавленного вами файла, но он не создает объект для 
вашего дерева сразу же. Вместо этого он обновляет индекс. Индекс хранит- 
ся в .2®/ш4ех и используется для отслеживания пути файла и соответству- 
ющих блобов. Каждый раз, когда вы выполняете команды вроде 2 аа4, Ей 
тт или ей то, СИ обновляет индекс, устанавливая новую информацию бло- 
ба и пути файла. 


Создать объект дерева из вашего текущего индекса можно с помощью низ- 
коуровневой команды 5 шще-{тее. 


Для просмотра содержимого индекса введите следующую команду (на мо- 
мент ее ввода индекс содержал только один файл - Ве!]о.6х0): 


$ а1Е 13з-Н1ез -$ 
100644 3618е5124Ъа79е4с83009908аеь 37 Е8е72858ааа 0 ве11о.ЕхЕ 
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Здесь мы видим, что файл Ве|о.(х& соответствует блобу 3Ь18е5.... Далее, да- 
вайте получим состояние индекса и сохраним его как объект дерева: 


$ а41Е мглее-егее 
68арфаб2е560с0ерс3396е8ае9335232са93а3{60 

$ Нпа .91е/об]есез 

.91Е/оБ]есез 

.91Е/ор)]есЕз/68 
.91Е/оБ]есез/68/абаб2е560с0еьс3396е8ае9335232са93За3Е60 
.91Е/ор)есЕз/раск 

.91Е/ор)есЕз/ЗЬ 
.916/ою)есез/3ь/18е512ара79е4с83009908аеЪ37#8е728ъЪ8даа 
„.а1е/ою3есез/1пЕо 


Теперь у нас есть два объекта: объект "Вео мог!" с ТО 3Ъ18е5 и новый объ- 
ект, объект дерева, с ГО 68аБаб. Как видите, имя объекта соответствует ка- 
талогу и файлу в каталоге .5й/оБесиз. 


Но как выглядит само дерево? Поскольку дерево - это тоже объект, подоб- 
но блобу, вы можете использовать ту же команду для его просмотра: 


$ а1Е саЕ-Я1е -р 68аБаб 
100644 Б1ор 3618е512ара79е4с83009908 аеб37Е8е728684аа пе11о.Ех®е 


Содержимое объекта просто интерпретировать. Первое число — 100644 — 
представляет атрибуты файла в восьмеричной системе, если вы работали с 
Отих, то вы с ними знакомы. Далее идет имя (3518е5) объекта, а Ве|о.(х& — 
имя файла, связанное с блобом. 


ПРИМЕЧАНИЕ ОТНОСИТЕЛЬНО ИСПОЛЬЗОВАНИЯ 
ЗНА1 


Перед более подробным рассмотрением содержимого объекта дерева, да- 
вайте посмотрим на очень важную функцию ЗНА1-хэшей: 


$ 41Е иглее-егее 
68араб2е560с0еьс3396е8ае9335232са93За3Е60 
$ 41Е иглее-егее 
68 араб2е560с0еьс3396е8ае9335232са93а3 {60 
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$ а1Е мг1ее-егее 
68абаб2е560с0ерс3396е8ае9335232са93За3 Е60 


Каждый раз, когда Вы вычисляете другой объект дерева для того же индек- 
са, хэш ЗНА1 остается неизменным. СЁ не должен воссоздать новый объект 
дерева. Если вы вводите эти команды на своем компьютере, то вы должны 
увидеть те же хэши, что и приведенные в этой книге. 


Хэш-функция — истинная функция в математическом смысле: для заданно- 
го ввода она всегда производит один и тот же вывод. 


Это чрезвычайно важно. Например, если вы создаете то же самое содержа- 
ние как другой разработчик, независимо от того, где или когда или как вы 
оба работаете, идентичный хэш - доказательство полной идентичности со- 
держимого. 


Но задержитесь на секунду. Разве ЗНА1 хэши не являются уникальными? 
Что произошло с триллионами людей с триллионами блобов в секунду, ко- 
торые никогда не произведут одну единственную коллизию? Это частый 
источник недоразумений среди новых пользователей Си. Внимательно 
продолжайте читать далее, поскольку если вы сможете понять эту разницу, 
тогда все остальное в этой главе — просто. 


Идентичные хэши ЗНА1 в этом случае не считаются коллизией. Коллизия 
— это если два разных объекта производят один и тот же хэш. Здесь же мы 
создали два отдельных экземпляра одного и того же содержимого, поэто- 
му хэш одинаковый (у одного и того же контента всегда будет одинаковый 
хэш). 


СИ зависит от другого последствия хеш-функции ЗНА1: не имеет значения, 
как вы получили дерево, названное 68аБаб2е560с0еБс3396е8ае9335232с493 
а3#60. Если оно есть у вас, вы можете быть полностью уверены, что это — тот 
же древовидныйобъект, который, скажем, есть у другого читателя этой кни- 
ги. Боб, возможно, создал дерево, комбинируя фиксации А и Вот Дженни и 
фиксации С от Сергея, тогда как вы получили фиксацию А от Сью и обнов- 
ление от Лакшми, которое комбинирует фиксации В и С. Результат — тот же, 
и это существенно упрощает распределенную разработку. 


Если вас попросили найти объект 68аБаб2е560с0ебс3396е8ае9335232са93За 
3Е60 и вы можете найти именно этот объект, поскольку ЗНА1 - криптогра- 
фический хэш и вы можете быть уверены, что нашли именно те данные, по 
которым был создан хэш. 
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Также истинно: если вы нашли объект с определенным хэшем в вашем хра- 
нилище объектов, вы можете быть уверены, что у вас нет копии этого объек- 
та. Хэш таким образом является надежной меткой или именем для объекта. 


‚Но СК также полагается на что-то более важное, чем просто заключение. 
Рассмотрим самую последнюю фиксацию (или связанный с ней объект де- 
рева). Поскольку она содержит, как часть ее контента, хэш ее родительский 
фиксаций и ее дерево содержит хэш всех его поддеревьев и блобов. А это 
означает, что хэш исходной фиксации однозначно определяет состояние це- 
лой структуры данных, которая основана на той фиксации. 


Наконец, импликации нашего требования в предыдущем абзаце приводят 
к мощному использованию хеш-функции: она предоставляет эффективный 
способ сравнения двух объектов, даже очень больших и сложных структур 
данных без передачи этих объектов полностью. 


ИЕРАРХИЯ ДЕРЕВЬЕВ 


Хорошо иметь информацию относительно одного файла, как было показано 
в предыдущем разделе, но проекты обычно более сложны и содержат глу- 
боко вложенные каталоги, которые со временем перестраиваются и переме- 
щаются. Давайте посмотрим, как СЁ обработает создание нового каталога, 
в который мы поместим полную копию файла Бе!]о.6хЕ 


$ риа 

/Епр/Ье11о 

$ шка1лк заБа1 к 

$ ср Ве11о.ЕхЕ заба1к/ 

$ а91Е ааа заБа1к/ве11о. хе 

$ а1Е мг1фе-егее 

492413269336421Еас079а4а4672е5545а2147ас 

$ а1Е саЕ-Н1е -р 4924132693 

100644 Р1оЬ 3518е512а5а79е4с8300а4908аеь37+8е728Ъ8ааа ве11о.ЕхЕ 
040000 Егее 68аБаб2е560с0еьс3396е8ае9335232са93а3Е60 зиБя1т 


В новом корневом дереве теперь есть два элемента: исходный файл БеПо.%х& 
и новый подкаталог заб г, который выводится как #тее, а не как оф. 


Что же тут необычного? Посмотрите на имя объекта зи г. Это наш старый 
друг — 68аБаб2е560с0еБс3396е8ае9335232с493За3{60! 
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Новое дерево для зиБ4и: содержит только один файл, Ве!]о.х& и этот файл 
содержит старый контент — строку "ВеПо \ог!4". Поэтому дерево зи БА! в 
глазах СК выглядит так же, как и корневой каталог. 


Теперь давайте посмотрим на каталог .5и/оБес{$ и посмотрим, на что 
повлияло это новое изменение: 


$ Нпа .91%/о6)есез 

.91Е/оБ)]есез 

.91Е/о5)есЕз/49 
.91%/06)ес+$/49/2413269336421Ёас079а4а4672е5545а2147ас 
.91Е/о5)есЕз/68 


.91Е/о5)есЕ3/68/аБаб2е560с0еьс3396е8ае9335232са93а3 {60 
.916/оБ]есез/раск 

.91Е/о5)]есез/ЗЬ 
.91%/о5)]есез/35/18е512а5а79е4с83004408аеЪ3 7 Ё8е728Ъ8ааа 


.91Е/оБ)]есЕз/1пЕо 


У нас все еще есть три уникальных объекта: блоб со строкой "Ве!]о \ог!4"; 
дерево, содержащее БеПо.1хь, в котором есть текст "Бе!о мог!" плюс новая 
` строка; второе дерево, которое содержит другую ссылку на Ве!]о.6хё в первом 
дереве. 


ФИКСАЦИИ 


Следующий объект для обсуждения - фиксации. Теперь, когда Бе|о.4х& был 
добавлен с помощью #й аа4 и был произведен объект дерева командой =й 
штиет-тее, вы можете создать объект фиксации, используя следующие ко- 
манды: 


$ есво -п "Сопма а В1е %Вае зауз Ве11о\п" \ 
| 91% сопо1е-6гее 4924132693364921#ас07944а4672е559542147ас 
Зе4е4622сс2415сЬ09683аЁ36360е74135 9ааЕ6с 


Результат будет примерно таким: 


$ 491% са&-й1е -р Зеае462 

Егее 4924132693364921Ёас079494а4672е5595492147ас 

асЕВог Фоп Тое11дег <)41@ехатр1е.сом> 1220233277 -0500 
сопи1Е$ег Фоп Т1ое11дег <)491@ехапр1е.сом> 1220233277 -0500 
Сопи1е а Н1е {Раф зауз Ве11о 
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Если вы выполняете примеры из этой книге на своем компьютере, вы, веро- 
ятно, обнаружили, что у объекта фиксации, сгенерированного вами, будет 
другое имя, которое отличается от приведенного в книге. Если вы до сих 
пор понимали все написанное, причина должна быть очевидной: это не та 
фиксация. Ведь фиксация содержит ваше имя и время создания фиксации, 
а эти данные в вашем случае будут отличаться. С другой стороны, у вашей 
фиксации есть то же дерево, что и в примерах. 


Это то, почему объекты фиксации отделяются от их объектов дерева: раз- 
ные фиксации часто относятся к одному и тому же дереву. Когда это проис- 
ходит, СЁ достаточно умен, чтобы передать только новый объект фиксации, 
который обычно крошечный, вместо копирования всего дерева и всех блоб- 
объектов, которые, наверняка, гораздо больше. 


В реальной жизни вы можете (и должны) вызвать команды 8 штще-{тее и 
5 соттй-1тее, и потом просто использовать команду 8й соттй. Вам не нуж- 
но помнить все команды, чтобы быть счастливым пользователем Си. 


Основной объект фиксации довольно прост и содержит следующее: 


® Имя объекта дерева, который фактически идентифицирует связанные 
файлы. 


® Имя человека, создавшего новую версию (аи йо?) и время создания этой 
версии. 


® Имя человека, который поместил новую версию (соттйе?) в репозито- 
рий и время фиксации. 


® Описание версии (сообщение о фиксации). 


По умолчанию ашйот и соттйет - это один и тот же человек. Но существу- 
ют ситуации, когда это разные люди. 


Примечание. Вы можете использовать команду 9 $Пом 
--ргену=МИег для просмотра дополнительной информации о за- 
данной фиксации. 


Объекты фиксации также хранятся в виде структуры графа, хотя эта струк- 
тура полностью отличается от структур, которые используются объектами 
дерева. Когда вы производите новую фиксацию, вы можете указать одну 
или больше родительских фиксаций. 
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ТЕГИ 


Наконец, мы добрались до последнего объекта, которым управляет СЁ — 
тег. Хотя в СЁ реализован тег только одного вида, на самом деле существует 
два вида тегов — легковесный и аннотированный. 


Легковесный тег — это просто ссылка на объект фиксации и обычно он част- 
ный для репозитория. Эти теги не создают постоянный объект в хранилище 
объектов. Аннотированный тег более существенный и создает объект, со- 
держащий сообщение, предоставленное вами и может содержать цифровую 
подпись, созданную с помощью СРС-ключа согласно КЕСА880. 


СЁ обрабатывает, как легковесные, так и аннотированные теги, но по умол- 
чанию большинство тегов СЁ работают только с аннотированными тегами, 
поскольку считают их "постоянными" объектами. 


Создать аннотированный тег с сообщением можно командой #й ва: 


$ 91Е Бад -м "Тад уегз1оп 1.0" \У1.0 3Зеае462 


Увидеть объект тега можно командой 2й саё-Ше -р, но как узнать хэш ЗНА1 
объекта тега? Чтобы найти его, используйте совет из "Объекты, хэши и бло- 
бы": 


$ 91Е геу-рагзе \1.0 

65608с1093943939ае783481174941861ра151сба 

$ 91 са+-Я1е -р 6Ъ608с 

ор]есЕ Зеде4622сс2415сЬ09683аЁ36360е7 4139 ааЕ6с 

фуре сот 

фаа \1.0 

фачдехг Фоп Тое11дег <)а1@ехапр1е.сом> Зиоп ОсЕ 26 17:07:15 2008 
—-0500 

Таз хегз1оп 1.0 

В дополнение к сообщению журнала и информации об авторе тег ссылается 


на объект фиксации (3Зе4е462). 


Си обычно тегирует объект фиксации, указывающий на объект дерева, ох- 
ватывающее общее состояние всей иерархии файлов и каталогов в вашем 
репозитории. 


Поведение СЁ не похоже на другие СКВ, где тег применяется отдельно к 
каждому файлу, а затем на основании коллекции этих теггированных фай- 


Глава 21. Контроль кода 


лов воссоздается целая теггированная версия. Другие СКВ позволяют вам 
перемещать теги отдельных файлов, а СИ требует создания новой фикса- 
ции, которая охватывает изменение состояние файла, тег которого был пе- 
ремещен. 


21.6. Управление файлами 


Когда ваш проект на попечении системы контроля версий, вы редактируете 
файлы проекта в своем рабочем каталоге, а потом передаете свои изменения 
в ваш репозиторий для сохранности. СИ работает также, но в нем есть про- 
межуточный уровень между рабочим каталогом и репозиторием - индекс. 
Индекс используется для подготовки, или организации, изменений. Когда 
вы управляете своим кодом с помощью СЁ, вы редактируете изменения в 
своем рабочем каталоге, накапливаете их в своем индексе, а затем фиксиру- 
ете то, что накопилось в индексе как один набор изменений. 


Вы можете думать об индексе, как о ряде намеченных или предполагаемых 
модификаций. Вы добавляете, удаляете, перемещаете или редактируете 
файлы до точки фиксации, которая реализовывает накопленные файлы 
в репозитории. Большая часть важной работы фактически предшествует 
шагу фиксации. 


Примечание. Помните, что фиксация — двухступенчатый про- 
цесс. Сначала вы подготавливаете изменения, а потом вы фик- 
сируете изменения. Изменение, найденное в рабочем каталоге, 
но не в индексе, не подготовлено и не может фиксироваться. 
Для удобства СЁ позволяет вам комбинировать эти два шага, 
когда вам нужно добавить или изменить файл: 


$ а1Е соппае 1пдех.Вет1 
Но если вы переместили или удалили файл, у вас не будет такой 
роскоши. Вам нужно будет выполнить два действия: 


$ 91Е га 1паех.БЕт1 
$ 491Е сопма Е 


Сейчас мы поговорим, как управлять индексом. Будет показано, как добав- 
лять и удалять файлы из вашего репозитория, как переименовать файл и 
т.д. 
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21.6.1. ВСЕ ОБ ИНДЕКСЕ 


Линус Торвальдс утверждал в списке рассылки СЁ, что вы не можете осоз- 
нать всю мощь С без понимания назначения индекса. 


Индекс СЁ не содержит названий файла, он просто отслеживает то, что вы 
хотите фиксировать. Когда вы выполняете фиксацию, СЁ проверяет ин- 
декс, а не ваш рабочий каталог. 


Несмотря на то, что многие высокоуровневые команды СЁ разработаны, 
чтобы скрыть детали индекса, все еще важно помнить об индексе и его со- 
стоянии. 


Вы можете запросить состояние индекса в любое время командой = 5а8и5. 
Она явно отображает файлы, подготовленные для фиксации (находящиеся 
виндексе). Также вы можете узнать о внутреннем состоянии СЁ командами 
вроде 2 [5-П/ез. 


Вероятно, вам пригодится команда &й 4. Эта команда может вывести на 
экран два различных набора изменений: 2й @/ выводит изменения, которые 
есть в рабочем каталоге, но которых нет в индексе; 5 Ч -сасВе4 выводит 
изменения, которые уже подготовлены (находятся в индексе) и будут по- 
мещены в репозиторий при следующей фиксации. 


21.6.2. КЛАССИФИКАЦИЯ ФАЙЛОВ В СИТ 


СЁ классифицирует ваши файлы на три группы: отслеживаемые, игнориру- 
емые и неотслеживаемые. 


ОТСЛЕЖИВАЕМЫЕ 


Отслеживаемым называется файл, уже находящийся в репозитории или в 
индексе. Чтобы добавить файл зотейЁ в эту группу, выполните команду Ей 


аа зотеЕе. 


ИГНОРИРУЕМЫЕ 


Игнорируемый файл должен быть явно объявлен невидимым или игнори- 
руемым в репозитории (даже при том, что он может присутствовать в ва- 
шем рабочем каталоге). В вашем проекте может быть много игнорируемых 
файлов: ваши личные заметки, сообщения, временные файлы, вывод ком- 
пилятора и большинство файлов, сгенерированных автоматически во вре- 
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мя сборки проекта. СЁ по умолчанию ведет список игнорируемых файлов, 
но вы можете настроить свой репозиторий для распознания других игнори- 
руемых файлов. Чуть позже будет показано, как это сделать. 


НЕОТСЛЕЖИВАЕМЫЕ 


Неотслеживаемым является любой файл, не относящийся к любой из пре- 


дыдущих двух категорий. СЁ просматривает весь набор файлов в вашем ра- 
бочем каталоге и вычитает из него отслеживаемые и игнорируемые файлы, 
в результате получается список неотслеживаемых файлов. 


Давайте исследуем разные категории файлов, создав совершенно новый ра- 
бочий каталог и репозиторий: 


са /+р/шу зеай 
91% 11016 


91 зфабиз 
Оп БгапсВ мазеег 


1Тп0161а1 сопи1е 


Нм 


поЕН1п9 Фо сопш1е (сгеафе/сору Н1ез ап изе "91 ааа" фо 
сгаск) 


$ есво "Новые данные" > Дафа 


$ 41 зфаеаз 
# Оп БгапсЬ мазфег 


1Тп01%&1а1 сопи1е 


ОпЕгаскеа Я1ез: 

(изе "а1Е ааа <#1е>..." о 1пс1аае 1п мВае и111 Бе 
сопт1$еа) 

$ 

# Чака 

поЕр1п9 аааеа +о сопп1е Бие ипЕгаскеа Н1ез ргезепе (изе "91+ 
ааа" фо +гаск) 


# 
# 
# 
# 
# 
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Изначально нет никаких отслеживаемых или игнорируемых файлов, поэто- 
му набор неотслеживаемых файлов пуст. Как только вы создадите данные, 
ЕЙ аи; покажет один неотслеживаемый файл. 


Редакторы и окружения сборки часто оставляют временные файлы среди 
вашего исходного кода. Такие файлы обычно не должны отслеживаться, как 
файлы исходного кода. Чтобы СЁ игнорировал файлы в каталоге, просто 
добавьте имя этого файла в специальный файл 5 рпоге. 


Вручную создадим файл, который будет игнорироваться 
Фоцср ша1п.о 

91Е збаёа$ 

Оп Бгапср мазфек 


Т0161а1 сопт1е 


ОрЕгаскеа Н1ез: 

(изе "а1Е ааа <Н1е>..." фо 1пс1аае 1п мраф м111 Бе 
сопт1{{еа) 

# 

$ Чафса 

# па1п.о 


На + + фф+ 


$ есво ша1п.о > .91%1дпоге 


91 зфаваз 
Оп Бгапср мазфег 


Опехгаскеа Н1ез: 
(изе "416 ааа <#1е>..." ео 1пс1аае 1п мпаф им111 Бе 
сопт1 {феа) 
# 
# „оле1лапоге 
# Часа 


$ 
+ 
+ 
# 10161а1 соптмл® 
+ 
+ 
+ 


Как видите, файл таш.о был проигнорирован, но 2 $а#и5 показал новый 
неотслеживаемый файл .51бпоге. Хотя этот файл имеет специальное на- 
значение в СК, он обрабатывается как любой другой обычный файл в пре- 
делах вашего репозитория. Пока .51впоге не будет добавлен, С будет рас- 
сматривать его как неотслеживаемый. 
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Следующие разделы демонстрируют несколько способов изменения стату- 
У 4 У 

са отслеживаемого файла, а именно добавление файла в индекс и удаление 

его из индекса. 


21.6.3. ИСПОЛЬЗОВАНИЕ @Т АОО 


Команда 2й аа организует файл, после следующей фиксации (2 соттй) 
такой файл будет добавлен в репозиторий. В терминологии Си файл будет 
неотслеживаемым, пока он не будет добавлен командой = а4А, что изменит 
его статус на отслеживаемый. Если команде #й а передать имя каталога, 
все файлы и подкаталоги этого каталога будут добавлены рекурсивно. 


Давайте продолжить пример из предыдущего раздела: 


$ «1% зфаеиз 
Оп БгапсВ мазеегк 


10161а1 сопп1е 


+ 
# 
+ 
# 
# Ппегаскеа Н1ез: 

$ (0зе "д91Е ааа <#1е>..." во 1пс1аае 1п мВаф м111 Бе 
сопи1 Е $еа) 

+ 

+ 

+ 

+ 


.9161апоге 
Ча*а 
Тгаск БоёН пеи Н1ез. 


< 


41Е ааа даа .91Е1дпоге 


91+ зфаеаз 
Оп БгапсН пазеег 


101&1а1 сопм1 


СВапаез во Бе сопма*еа: 
(изе "91 гм --сасВеа <Н1е>..." 6о ипзфазе) 


рем Н1е: :31&1дпоге 
пем Н1е: Чафа 


Ноа а а чо 


Первая команда-Ей $15 показывает, что у нас есть два неотслеживаемых 
9” и напоминает, что для того, чтобы сделать файл отслеживаемым, 
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нужно просто использовать команду #й ааа. После выполнения команды Ей 
ааа оба файла (аа и 45поге) будут отслеживаться и будут подготовлены 
для помещения в репозиторий при следующей фиксации. 


В терминах объектной модели СЁ добавление файла командой 2й аа оз- 
начает копирование файла в хранилище объектов и его индексирование. 
Организацию файла (2й а4а) так же называют "кэшированием файла" или 
"помещением файла в индекс". 


Вы можете использовать команду =й [5-1е; для определения хэш-кодов для 
организованных файлов: 


$ аз 13-Я1ез --з6аде 
100644 0487Е44090а49950Е61955271сЕ0а2абсба8Заа9а 0 .91Е1апоге 
100644 534469Е67ае5се72а7а274ЕаЕЗ304ее3с2еа1746а 0 аака 


Большинство ежедневных изменений в вашем репозитории, вероятно, бу- 
дут простыми правками. После редактирования и перед фиксацией изме- 
нений нужно запустить 2й ааа для обновления индекса, чтобы занести 
в него последнюю и самую высокую версию вашего файла. Если вы это не 
сделаете, у вас будут две разные версии файла: одна из хранилища объек- 
тов, на которую ссылается индекс, и другая - в вашем рабочем каталоге. 


Чтобы продолжить пример, давайте изменим данные файлы так, чтобы они 
отличались от тех, которые есть в индексе. После сего, командой &й разй- 
обес: <файл> вычислим и отобразим хэш новой версии файла. 


$ аз 13-Я1ез --зваде 

100644 0487Е44090аа950Е61955271сЕ0а2абсба8Заа9а 0 .91Е1дпоге 
100644 534469Е67ае5се72а7а274ЕаЕ30аее3с2еа1746а 0 аафа 

# отредактируйте файл "Чака"... 

$ саеё аафа 

Новые данные 

Еще немного данных 

$ 41Е Вазн-оБЗесе дафа 

е476 98 3Е39Е6е4Е453Е0Ее4а8 5941063585500 

АЕсег +Бе Н1е 15$ амепаеа, Еве ргеу1ои$ уегз1оп оЕЁ Ее Не 1п 
ре ор)есЕ з6оге апа 1паех 

Ваз $ЗНА1 534469Е67ае5се72а7а274ЁЕаЁЗ304ее3с2еа1746а. Номеуег, 
{ре праафеЯа уег$1оп 

оЕ Пе Н1е Ваз $НА1 е476983Е39Е6е4Е453Е0Ее4а859410#635585500. 
Тее'5$ ирааее +ще 

1паех со сопеа1п Бе пем уегз1оп оЁ Ете Не: 
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$ 414 ааа аафа 

$ 414 13-В1ез --зваде 

100644 0487Е44090аа950Е61955271сЕ0а2абсба8Заа9а 0 .91Е1чпоге 
100644 е47698ЗЕЗЭ9Ебе4 Е453Е0Ее4а859410Е635585500 0 аака 


Теперь индекс содержит обновленную версию файла. Снова, "данные фай- 
ла были подготовлены (для фиксации)" или, проще говоря, "данные файла 
были помещены в индекс". Последняя фраза не очень точная, но зато более 
понятная. 


Опция --ниегасйуе для команд &й ааа или 5й соттй может быть полезна, 
чтобы узнать, какие файлы вы бы хотели подготовить для фиксации. 


21.6.3. НЕКОТОРЫЕ ЗАМЕЧАНИЯ ОТНОСИТЕЛЬНО 
ИСПОЛЬЗОВАНИЕ @Т СОММИТ 


ИСПОЛЬЗОВАНИЕ СИТ СОММИТ -АЕе 


Опция -а или --а| команды &й соттй заставляет СЁ автоматически под- 
готавливать все неподготовленные, прослеженные изменения файла, в том 
числе удаление отслеживаемых файлов из рабочей копии, перед осущест- 
влением фиксации. 


Давайте посмотрим, как это работает, установив несколько файлов с разны- 
ми характеристиками подготовки: 


# Устанавливаем тестовый репозитарий 

$ шка1хг /+тр/соппа &-а11-ехапшр1е 

$ са /Емр/соп1*-а11-ехашр1е 

$ «1 111% 

1Т1161а112еа епшрфу С1Е героз1еогу 1п /&пр/сопи1е-а11-ехапр1е/. 
91Е/ 

$ есво зощеЕР1пд >> геаау 

$ есво зомЕВ1пд е1зе >> пофуеё 

$ 491% ааа геаау повуее 

$ 42% сопи1 -м "беёор" 

[пазфег (гоо®-сопм1е) 71774а1] Зебор 

2 Н1ез свапдеа, 2 1пзегЕ1опз (+), 0 ае1ее1опз (-) 

сгеафе моае 100644 посуее 

сгеафе моае 100644 геаау 

# Изменяем файл "геа4у" и добавляем командой "916 ааа" его в 
индекс 

$ 916 ааа геаау 
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# Изменяем файл "побуеё" 

# редактируем "побуе®" 

# Добавляем новый файл в подкаталог, но не добавляем его в 
репозиторий 

$ шка1к зира1 к 

$ есро Море >> зиба1г/пеи 


Используем #й $авиз, чтобы просмотреть изменения, требующие фиксации: 


91Е зкабиз 

Оп БкапсВ мазкег 

Срапаез Фо Бе сопитеееа: 

(изе "916 гезефк НЕАО <Н1е>..." со опзфаде) 


поЧ1Неа: геаау 


СрапаеЯ Бо поЕ ирадаеа: 
(изе "а16 ааа <Н1е>..." ео ирдаЕе иВаф и111 ре сопи1$еа) 


поа1НеЯ: пофуее 


Опсгаскеа Нез: 

(изе "а1Е ааа <Н1е>..." во 1пс1а4е 1п иВаф и111 Бе 
сопм1 фея) : 

$ 

# зиБа1г/ 


$ 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 


Здесь индекс подготовлен для фиксации только одного файла -— с именем 
теаду, поскольку только этот файл был подготовлен (добавлен). 


Однако, если вы запустите команду &й соттй -аЙ, СЕ рекурсивно обойдет 
весь репозиторий, организует все известные, измененные файлы. В этом 
случае, когда ваш редактор представит шаблон сообщения фиксации, он 
должен указать, что измененный и известный файл побуеё тоже будет фик- 
сироваться: 


Р1еазе епеег (Бе сопи1е шеззаде Ёог уопг сВапдез. 
(СомтепЕ 11пе5 зЕахг®1па м1ЕВ '#' м111 поЕ Бе 1пс1оаея) 
Оп БгапсВ мазкег 

Срапаез во Бе сопи1Ефеа: 

(изе "а16 гезеф НЕАР <Н1е>..." со опзбаде) 


= = === 
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# поа1Неа: пофуее 

# поа1Неа: геаау 

# 

# Опегаскеа Нез: 

# (оэе "д1Е ааа <Н1е>..." 6о 1пс1а4е 1п "рае и111 ъе 
сопи1 Е еа) 


# 
# зоБа1к/ 


Наконец, поскольку каталог с именем зи БЧ!г/ новый и в нем не находится 
ни один из файлов, даже опция --а!| не заставит его фиксироваться: 


СгеафеЯ сопи1+ а57ае5Е: Зоще --а11 +Б1па. 
2 Н1ез срапдеа, 2 1пзегЕ1оп$ (+), 0 ае1ее1олпз (-) 


СИрекурсивно обойдет репозиторий в поисках измененных и файлов. Пол- 
ностью новый каталог зиБ!т/ и всего его файлы не станут частью фиксации. 


НАПИСАНИЯ СООБЩЕНИЙ ЖУРНАЛА ФИКСАЦИИ 


Если в командной строке вы явно не указываете сообщение журнала, СЁ 


запустит редактор и предложит вам написать его. Будет запущен установ- 
ленный в вашей конфигурации редактор. 


Если вы выйдете из редакторе без сохранения, СИ будет использовать пу- 
стое сообщение журнала. Если вы уже сохранили сообщение, но еще не 
вышли из редактора, вы можете удалить сообщение и опять сохранить - 
тогда СЁ тоже сохранит пустое сообщение фиксации. 


21.6.4. ИСПОЛЬЗОВАНИЕ @ИТ ВМ 


Команда &й тт, как и ожидается, обратна для 2й ааа. Она удаляет файл из 
репозитория и рабочего каталога. Однако удаление файла может быть бо- 
лее проблематичным (если что-то пойдет не так), чем добавление файла. 
Поэтому СЁ относится к удалению файла с большей осторожностью. 


СЕ может удалить файл только из индекса или одновременно из индекса и 
рабочего каталога. СЁ не может удалить файл только из рабочего каталога, 
для этого используется команда операционной системы 771. 
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Удаление файла из каталога и из индекса не удаляет историю файла из ре- 
позитория. Любая версия файла до момента удаления хранится в хранили- 
ще объектов и не будет оттуда удалена. 


Давайте представим, что у нас есть некоторый файл, который мы еще не 
добавили в репозиторий (не выполнили команду &й а44), и мы пытаемся 
удалить его командой 8й 7т: 


$ есВо "Вапаом звоЁН" > оорз 

# Не можем удалить файл, не добавленный в репозиторий 
# Нужно использовать команду "ка оорз" 

$ 91Е км оорз 

Еафа1: раеВзрес 'оорз' @а1А поЕ мафсВ апу Н1ез 


Теперь давайте добавим файл командой 2 ада, а затем выполним команду 
Бе хаи5;: 


Добавляем файл 
91Е аа оорз 

91Е зкафиз 

Оп БгапсВ мазкег 


10161а1 сопм1е 


СВапаез во Бе сома ееа: 
(изе "а1Е га --сасВеа <Н1е>..." о ипзфаде) 


пеи ВН1е: .91Е1апоге 
пеи Н1е: аафа 
пем Н1е: оор5 


+ чо о+ 


Чтобы конвертировать файл из подготовленного в неподготовленный, ис- 
пользуйте команду &й тт --сасйеа: 


$ 914 13-й1ез --зваде 

100644 0487Е44090а49950:61955271сЕ0а2абсба8Заа9а 0 .„.91Е1апоге 
100644 е476983ЕЗ39Е6бе4Е453Е0ЁЕе4а859410Е635585500 0 ааа 
100644 Ес9875055Е261557434Еа9956ебсе29433а5с4а1с 0 оорз 

$ а41Е га --сасье оорз 

ги 'оорз' 

$ 914 13-й1ез --зваде 
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100644 0487Е44090а4950Е61955271сЕ0а2абсба8Заа9а 0 .31Е1дпоге 
100644 е476983Е39Е6е4Е453Е0Ее4а859410Е635585500 0 ааЕа 


Обратите внимание: 2 тт --сасйей удаляет файл только из индекса, но 
оставляет его в рабочем каталоге, в то время как команда &й 7т удаляет 
файл, как из индекса, так и с рабочего каталога. 


Примечание. Использование команды 9й гт --саспеЯ делает 
файл неотслеживаемым, в то время как его копия остается в ра- 
бочем каталоге. Это довольно опасно, так как вы можете забыть 
о нем, и файл больше никогда не будет отслеживаемым. Будьте 
осторожны! 


Если вы хотите удалить файл, как только он был зафиксирован, просто 
отправьте запрос через команду 5 гт <файл>: 


$ 41 сошла -щм "АЗА зоше Й1ез" 

Сгеафеа 1п1%1а1 сопи1е 522108: Ааа зоме Нез 
2 Н1ез срапдея, 3 1пзег®1опз(+), 0 ае1ее1опз (-) 
сгеафе по4е 100644 .ч1+1дпоге 

сгеафе поае 100644 даа 

$ 41% ка аафа 

га 'Чаба' 

$ 41 зваеаз 

# Оп БЬгапсВ мазбег 

# Стапдез фо Бе сопплЕфеа: 

# (позе "д1Е гезеф НЕАР <Н1е>..." со опзфасде) 
$ 

$ Че1ефеЯ: аафа 

$ 
Перед удалением файла СЁ проверяет, соответствует ли версия файла в 
рабочем каталоге последней версии в текущем ответвлении (в версии, ко- 
торую команды СК называют НЕАО). Эта проверка устраняет случайную 
потерю любых изменений, которые, возможно, были сделаны в файле. 


Примечание. Используйте команду 9 гт -Ё для принудительно- 
го удаления вашего файла. В этом случае файл будет удален, 
даже если он был изменен с момента последней фиксации. 


РУПоп. Полное руководство Оооо [= руфВоп 


Если вам нужно сохранить файл, который вы случайно удалили, просто 
добавьте его снова: 


$ 91% ааа аава 
Еафа1: ра Бзрес 'Чафа' 41а поЕ мафсВ апу Н1ез 


Ошибочка вышла! СЁ ведь удалил и рабочую копию тоже! Но не волнуй- 
тесь, УС$ содержит отличный механизм восстановления старых версий 
файлов: 


$ 91 свескосе НЕАО -- Зафа 

$ саф аафа 

Новые данные 

Еще немного новых данных 

$ 41 зфаваз 

# Оп Бгапсь пазеек 

поЕр1па во сопм1Е (могк1па а1гесеоку с1еап) 


21.6.5. ИСПОЛЬЗОВАНИЕ @Т МУ 


Предположим, что вам нужно удалить или переименовать файл. Вы можете 
использовать комбинацию команд 2й тт (для удаления старого файла) и Ей 
а4А (для добавления нового файла). Или же вы можете использовать не- 
посредственно команду Ей то. Представим, что в нашем репозитории есть 
файл с именем 5ми{и вы хотите переименовать его в пеши. Следующие 
две последовательности действий являются эквивалентными: 


$ шу эзЕаН пемзой 
$ 91Е ка звай 
$ 91Е ааа пемзеаЯ 


ИЛИ 


$ 91Е шу зЕаН пемзеай 


В обоих случаях СЁ удалит путь $} из индекса, добавит новый путь 
пеши], сохраняя оригинальное содержимое 54} } в хранилище объектов и 
реассоциирует это содержимое с путем пеши]. 


Файл да мы уже восстановили, теперь давайте его переименуем в туда: 


$ 414 шу ааеа шудафа 
$ 41Е зкаеаз 

# Оп БЬгапсВ мазеег 

# Спапаез во Бе сопт1 ея: 

$ (пзе "а1е гезеф НЕАО <Н1е>..." 6о ипзфасе) 
# 

$ гепашеЯ: Чафа -> шудафа 

# 

$ 41 соши1 -ш "МоуеЯ Аафа Фо шудажа" 
Сгеафеа сопп1е ес749888: МохеЯ аафа Ко мудафа 


1 шез сВапраеа, 0 1пзегЕ1опз(+), 0 ае1ее1опз (-) 
гепаше Чафа => пудафа (100%) 


Если вы проверите историю файла, вы можете быть немного удивлены, ког- 
да увидите, что СА, очевидно, специально потерял историю исходного фай- 
ла и помнит, только, что данные были переименованы: 


$ 914 1од тудафа 

сопм1 Е. ес7988856492370а8е{43#56162а2а4686баеа3Ъ4 
АЧЕНог: Фоп Тое11дег <)91@ехапр1е.сом> 

Рафе: 5ип М№оу 2 19:01:20 2008 -0600 

МотеЯ Чафа $о шуаафа 


СЁ все еще помнит всю историю, но отображает только то, что касается 
определенного имени файла, указанного в команде. Опция --Юо\ просит 
СИ отследить журнал и найти всю историю, связанную с контентом: 


$ 41+ 1од --Е011ом шудаеа 

сопт1Е ес7а88856492370а8еЕ43Е56162а2а468баеа3Ъ4 
АцеВог: Фоп Гое11дег <)а1@ехапр1е.сом> 

Рафе: 5ип Му 2 19:01:20 2008 -0600 


Моуеа Чака о му4афа 
сопт1е 52210882056638а86Ъ{57145а136Е3а7аЪ 71818 


АцеВог: Фор Гое11дег <)91@ехапр1е.сом> 
Рафе: 5ип Му 2 18:38:28 2008 -0600 


Руфоп. Полное руководство 


Аа зоме Нез 


ру+Поп 


Одна из классических проблем многих УС$ заключается в том, что после 
переименования файла невозможно отследить его историю. В СЦ эта 
проблема решена. 


21.6.7. ЗАМЕЧАНИЕ ОТНОСИТЕЛЬНО 
ОТСЛЕЖИВАНИЯ ПЕРЕИМЕНОВАНИЙ 


Давайте немного подробнее рассмотрим отслеживание переименований 
файла. 


ЗУМ, как пример традиционного управления версиями, производит боль- 
шую работу по отслеживанию во время переименования/перемещения 
файла, поскольку она отслеживает только разницу между файлами. Если 
вы перемещаете файл, то это, по сути, то же, что и удаление всех строк из 
старого файла и их добавление в новый файл. Но передавать все содержа- 
ние файла каждый раз, когда вы делаете простое переименование, очень не- 
эффективно. Подумайте о том, что будет, если нужно переименовать целый 
подкаталог с тысячами файлов. 


Чтобы облегчить эту ситуацию, ЗУМ явно отслеживает каждое переимено- 
вание. Если вы хотите переименовать Ве!]о.6хё в зиБа/БеПо.6хе, вы должны 
использовать команду 50п то вместо команды 50п тт и 504 аа4. Иначе ЗУМ 
никак не поймет, что это переименование и ему придется пойти по неэф- 
фективному пути удаления/добавления, что и было описано выше. 


Затем, учитывая эту исключительную функцию отслеживания переиме- 
нования, ЗУМ нуждается в специальном протоколе, чтобы сказать его кли- 
ентам: "переместите файл Ве!]о.6хё в зиБ4т/веПо хе". Кроме того, каждый 
клиент ЗУМ должен убедиться, что выполнил эту работу правильно. 


СЛЬ, с другой стороны, не отслеживает переименование. Вы можете пере- 
местить или скопировать Бе]о.4хё куда угодно, но это влияет только на 
объекты дерева. Помните, что объекты дерева хранят отношения между 
содержимым, тогда как само содержимое хранится в блобах. Посмотрев на 
разницу между двумя деревьями, становится очевидным, что блоб с именем 
3Ь18е5 переместился в новое места. 


В этой ситуации, как и во многих других, система хранения СИ, основанная 
на хэше, упрощает много вещей по сравнению с другой КС$. 
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ПРОБЛЕМЫ С ОТСЛЕЖИВАНИЕМ 
ПЕРЕИМЕНОВАНИЯ 


Отслеживание переименования файла порождает постоянные дебаты среди 
разработчиков УС5. 


Простое переименование - объект разногласия. Аргументы становятся еще 
более весомыми, когда изменяется и имя, и содержимое файла. Тогда сце- 
нарий переговоров переходит от практического к философскому. Что это: 
переименование или новый файл (раз у него другое содержимое и другое 
имя)? Насколько новый файл подобен старому? Если вы применяете чей- 
то патч, который удаляет файл и воссоздает подобный в другом месте, как 
это обрабатывать? Что произойдет, если файл переименован двумя различ- 
ными способами на двух разных ветках? Какая тактика менее подвержена 
ошибкам: используемая в СЁ или в ЗУМ? 


В реальной жизни, похоже, что система отслеживания переименований, ис- 
пользуемая в СК, очень хороша, поскольку есть много способов переиме- 
новать файл и человек может просто забыть уведомить ЗУМ об этом. Но 
помните, что нет идеальной системы для обработки переименований, к со- 
жалению. 


21.6.8. ФАЙЛ „СИИМСМОВЕ 


Ранее в этой главе было показано, как использовать файл .=епоге для иг- 
норирования файла таш.о. Чтобы проигнорировать любой файл, просто 
добавьте его имя в файл .51впоге, который находится в этом же катало- 
ге. Вы также можете игнорировать файлы где угодно, добавив его в файл 
аНаепоге, который находится в корневом каталоге вашего репозитория. 


Но Си предоставляет более богатый механизм. Файл .Репоге может со- 
держать список шаблонов имен файлов, указывающий, какие файлы нужно 
игнорировать. Формат .5епоге следующий: 


» Пустые строки игнорируются, как и строки, начинающиеся с решетки 
(#). Такие строки можно использовать для комментариев, однако символ 
# не представляет комментарий, если он не является первым в строке. 


® Обычные имена файлов соответствуют файлу в любом каталоге с ука- 
занным именем. 


РУпоп. Полное руководство 


® Имя катала отмечается с помощью слеша (/). Это правило соответствует 
любому каталогу или любому подкаталогу, но не соответствует файлу 
или символической ссылке. 


® Шаблон может содержать маски оболочки, такие как звездочка (*). Звез- 
дочка может соответствовать единственному имени файла или каталога. 
Также звездочка может быть частью шаблона, включающего наклонные 
черты для обозначения имен каталогов, например, деБиё/32Ы&/*.о. 


» Восклицательный знак (!) инвертирует смысл шаблона оставшейся ча- 
сти строки. Дополнительно, любой файл, исключенный предшеству- 
ющим образцом, но соответствующий этому правилу инверсии, будет 
включен. У инверсии более высокий приоритет. 


Кроме того, СЁ позволяет вам создавать файл .1впоге в любом каталоге 
вашего репозитория. Каждый такой файл влияет на свой каталог и все под- 
каталоги. Правила .51епоге каскадные: вы можете переопределить прави- 
ла в каталоге более высокого уровня, включив инвертированный шаблон (с 
использованием ! в начале правила) в одном из подкаталогов. 


Приоритет игнорирования следующий: 
® Шаблоны, определенные в командной строке 


® Шаблоны, прочитанные из файла .5рпоге, находящего в том же ката- 
логе 


® Шаблоны в родительских каталогах. Шаблоны, находящиеся в текущем 
каталоге, будут перезаписывать шаблоны родительского каталога, сле- 
довательно, шаблоны более близкого родителя перезапишут шаблоны 
родителя более высокого уровня. 


® Шаблоны из файла .5и/шЮ/ехси4е 


» Шаблоны из файла, указанного переменной конфигурации соге. 
ехса4е е. 


Поскольку .51епоге обрабатывается как обычный файл в вашем репози- 


тории, он копируется во время операций клонирования и применяется ко 
всем копиям вашего репозитория. 


Если образец исключения, так или иначе определенный для одного вашего 
репозитория, не должен применяться к какому-нибудь клону этого репози- 
тория, то шаблоны должны находиться в файле .2и/шЮ/ехсаде, поскольку 
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он не копируется во время операций клонирования. Формат его шаблонов 
полностью совпадает с форматом файла .51епоге. 


Рассмотрим другой сценарий. Нам нужно исключить файлы *.0, сгенериро- 
ванные компилятором из исходного кода. Для игнорирования этих файлов 
поместите шаблон *.0 в файл .51епоге самого верхнего уровня. Но что если 
в определенном каталоге у вас есть определенный .о файл, который нужно 
отследить? Тогда у вас может быть примерно эта конфигурация: 


$ са му раскКаде 

$ саф .ч91Е1апоге 

* 50 

$ са пу раскаде/уепдог_Н1ез 
$ саё .91&1апоге 

| атлуег.о 


Данная конфигурация игнорирует все .о файлы в репозитории, но СЁ будет 
отслеживать одно исключение — файл 4пуег.о в подкаталоге уеп4дог_#]ез. 


ГЛАВА 22. 


ОПТИМИЗАЦИЯ КОДА 
РУТНОМ 


е ру Глава 22. Оптимизация кода Ру поп 


Профилирование используется для поиска узких мест в коде программы. 
Посредством профилирования разработчик или тестировщик может найти 
части кода, выполняющиеся дольше остальных. Далее, разработчик может 
оптимизировать эти части так, чтобы они выполнялись быстрее. В РуВоп 
имеется три встроенных профайлера: сРуое, ртоШе и ПоёзйоЕ. Последний 
использовать не рекомендуется - он устарел и уже не поддерживается. Мо- 
дуль ртой!е это в корне своем модуль Ру&Воп, но добавляет много чего сверху 
в профилированные программы. Поэтому лучше использовать сРоДЕ, ко- 
торый содержит интерфейс, имитирующий модуль рто/#. 


22.1. Профилирование кода с 
помощью сРгоШе 
Профилировать код с помощью сР’о#е достаточно просто. Вам нужно толь- 


ко импортировать модуль и вызвать команду тип. Сразу рассмотрим 
простенький пример: 


1прогЕ ВазН11Ь 
1прогЕ сРгоН1е 


Ру{поп. Полное руководство ООО [о ру Поп 


СРЕкОН1е. кип ("раз1115.п4а5 (ь'Ве11о') .а1дезЕ ()") 


Результат профилирования показан на рис. 22.1. 


5. ЕЕ $вей 392 - о х 


Ее Ечи ей ПРебиуд Орноп$ Мутадом Нер 

РуЕПоп 3.93.2 {{а9$/У3.9.2:1а79785, геь 19 2021, 13:44:55} [М5С ч.1928 64 61% (АМ ^ 
064)} оп м1п32 

Туре “ве1?р", "совуг190%", "сгеа145” ог "11сепзе{}" Гог моге 1пЁогта®1оп. 

‚5 Ваз$В11Ь 

СРгоЁ11е 

Зе.гоп ("Баз 118.95 {Ве о} Ятавее") 

5 Рипсё1оп са115 11 0.001 5есопаз 


Ог4еге4 Бу: збапдага паме 


пса115 Томе регса11 сашейте регса11 Ё11епапе: 11пепо (Ропсё1оп) 
нь 0.000 0.000 0.001 0.001 <зте1пд>: 1 {<аоди1е>} 
1 9.000 0.000 0.000 0.000 {5ц11Е-1п шеепоЯ _паз5ВЗЛЬ. ореп$51 _ 
па5} 
1 0.000 0.000 0.002 0.001 [Рил1Е-1л шеблоя Би1105.ехес} < 
а 0.000 0.000 0.006 0.000 {шефвоа '41де5%' оЁ '_вазВ115.НАЗН 
' ОБ3ест5} 
1 0.000 0.000 0.000 0.000 {шетноа '41заБ1е’ оЕ ' 1зрго#.РгоЕ 
13ег' о5)есе$} 


>>> | 


“ 


Е 1:18 СоЕ4 


Рис. 22.1. Результат профилирования 


Здесь мы импортировали модуль разйИЬ и использовали сР’оШе для про- 
филирования того, что создал хеш МО5. Первая строка показывает, что в 
ней 5 вызовов функций. Следующая строка говорит нам, в каком порядке 
результаты выдачи. Здесь есть несколько столбцов. 

» пса — это количество совершенных вызовов; 

» оШте - все время, потраченное в данной функции; 


» рексай- ссылается на коэффициент (о те, деленный на пса|$; 


» ситите - совокупное время, потраченное как в данной функции, так и 
наследуемых функциях. Работает также и с рекурсивными функциями. 


@® рутпоп ее, Глава 22. Оптимизация кода Рутоп 


® Второй столбец регсаЙ -— это коэффициент ситИише, деленный на при- 
митивные вызовы; 


» П/епате]тепо(ритсйоп) предоставляет соответствующие данные о каж- 
дой функции. 


Примитивный вызов — это вызов, который был совершен без рекурсии. Это 
очень интересный пример, так как здесь’нет очевидных узких мест. Давайте 
создадим часть кода с узкими местами, и посмотрим, обнаружит ли их про- 


файлер. 


# -*- соа1па: а Е-8 -*- 
1троке Е1те 


АеЕ Газ* (): 
рг1п* ("Быстрая функция") 


аеЁ з1ом (): 
ф1ще.з1еер (4) 
рг1п® ("Медленная функция") 


аеЕ шеа1ом (): 
ф1ще.з1еер (0.5) 
рг1п& ("Средняя функция...") 


аеЕ талп(): 
Еаз® (). 
$1ом () 
пеа1 ом () 


1Е _ папе__ == '_па1т__'; 
па1т () 


Сохраните программу как ргойез.ру. В этом примере нами создано четы- 
ре функции. Первые три работают с разными темпами. Быстрая функция 
запустится с нормальной скоростью, средняя функция потратит примерно 

‚ полсекунды на запуск, медленная функция потратит примерно 5 секунд 
для запуска. Главная функция вызывает остальные три. Давайте запустим 
сРтойЕ в этой простой программе: 


Рупоп. Полное руководство а, 2, ру{Поп 


1прогЕ сРгой1е 
1прогЕ ргоЕезе 


СРГОНТе. гоп ('ргоЕбезе.ма1п ()') 


Рис. 22.2. Результат профилирования 


Наэтот раз мы видим, что у программы ушло 4.536 секунды на запуск. Если 
вы изучите результаты, то увидите, что сРгоШе выявил медленную функ- 
цию, которая тратит 4 секунды на запуск. Это и есть самая "слабая" часть 
основной функции. Обычно, когда вы обнаруживаете такие места, есть два 
варианта развития ситуации: 


1. Вы приходите к заключению, что такая задержка приемлема. 


2. Переписываете алгоритм (код), если это возможно. 


В нашем простом примере, мы знаем, что лучший способ ускоритьфункцию, 
то убрать вызов Ите.з$еер, или, по крайней мере, снизить продолжитель- 
ность сна. На практике бывает сложно определить, как можно оптимизиро- 
вать программу и часто оптимизация заключается в изменении алгоритма 
ее работы. При необходимости можно также вызвать сРгое в командной 
строке, вместо применения в интерпретаторе. Вот как это можно сделать: 


руЕРоп -м сРГОН1е реезЕ.ру 


В этом случае сРюо(е будет запущен в вашем скрипте аналогично тому, как 
мы делали это ранее. Вам нужно сохранить выдачу профайлера? сРюоШе 
также позволяет это сделать. Все что вам нужно, это передать ему параметр 
—0, за которым следует название (или путь) файла. Пример: 


руеРоп -м сРгоН1е -о опЕраЕ.ехЕ ргоЕбез®.ру 


К сожалению, файл результата едва ли можно назвать читаемым. Для его 
чтения вам пригодится модуль Руфоп рзаё5. Вы можете использовать 
ряа5 для форматирования выдачи разными способами. Разберем пример, 
демонстрирующий, как получить выдачу, по аналогии с тем, как мы делали 
это раньше: 


проге рэзбафез 
р = рэзэвае$.56аф$ ("опЕрие. хе") 
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Р.5Ег1р_ 91г5().5огЕ 5%а®$(-1) .рг1пе_56а%$ () 


Вызов 5 1р_ 4$ вырезает все пути к модулям из вывода, а вызов 5075645 
делает сортировку, которая нужна нам для виденья картины. В документа- 
ции по сР’о}Ше вы найдете множество интересных примеров, которые 
наглядно демонстрируют различные пути извлечения информации с ис- 
пользованием модуля рав. 


Конечно, можно использовать средства перенаправления ввода/ вывода 
операционной системы: 


руЕВоп -м сРгой1е ргоЕбез®.ру > ое. хе 


В этом случае вы сразу получите читаемый текстовый файл. 


22.2. Практический пример: 
вычисление скорости загрузки сайта 


В данном примере мы пройдем небольшой марафон и узнаем, какой сайт 
быстрее всех откроется из нашей программы. 


$ -*- соа1па: чЕЕ-8 -*- 
1проге гедаез*$ 
1проге сРгой1е 


ЧеЕ Еасероск () : 

геаиезез . деф ('ВЕЕрз://Еасероок.сом') 
аеЕ чооа1е (): 

геаиезез.де® ('ВЕЕрз://дооа1е.сом') 
аеЕ Ем1ЕЕег(): 

геадиезез . деф ('ВЕЕрз: / /Ем1Еег.сом') 
АеЕ 1епфа(): 

геаиезез . деф ('ПЕЕрз://1епеа.ги') 


аеЁЕ па1п(): 
Еасероок () 
а0091е() 
фм1еег() 


РУпПоп. Полное руководство (ПД Фа РУЖВОй 


1епба () 
сРгоН1е.гил ( 'ма1п ()') 


Далее мы сократили вывод профайлера, удалив все лишнее: 


48556 ЕопсЕ1оп са11$ (48476 рг1и1Е1\уе са11$) 1п 2.158 зесопа$ 
Огадегеа Бу: зЕапЧага паме 


пса11$ ФоЕЕ\Шпе регса11 сошЕеше регса11 Непапе : 11тепо (Рапс®1оп) 


1 0.000 0.000 1.023 1.023 зреедЕезе.ру:10 (дооа1е) 
1 0.000 0.000 0.462 0.462 зрееЧЕезе.ру:12 (Еи1Ефет) 
1 0.000 0.000 0.216 0.216 зрееабезе.ру:14 (1епфа) 

1 0.000 0.000 2.158 2.158 зрееатез+.ру:18 (та1п) 

1 0.000 0.000 0.457 0.457 зрееаЕез*.ру:6 (Еасероок) 


Самым медленным стал Сооз]е, затем — Туихег, чуть быстрее (хотя пример- 
но такой же) — ЕасеБоокК, а самый быстрый — Гепба.ти. 


22.3. Событийные профайлеры 


Событийные (еоепё-разей) профайлеры привязаны к событиям, как не- 
сложно догадаться из их названия. Статистические профайлеры срабаты- 
вают каждые М раз. А событийные профайлеры — только в определенных 
случаях, например, после вызова функции или завершения работы функ- 
ции (смотря, к какому событию они привязаны). 


Событийные профилировщики заметно точнее статистических, но точ- 
ность здесь достигается в ущерб скорости работы. Из-за этого ними редко 
пользуются в продакшене. На Руфоп мы можем написать свой профайлер 
— при желании: 


1прогЕ $у$ 


аеЕ ргоН1ег (Ёгатше, ехуепЕе, акгаз): 
рг1пе (Егаме.Е 11пепо, еуепе, агаз) 
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зуз.зеЕргой1е (ргой1ег) 


АаеЁ ма1т (папе) : 
рг1п® ('Не11о, %$!' % папе) 


1Е _ паше__ == '_ ма1т__*': 
ша1т ('иог1а') 


Самое интересное здесь происходит после вызова функции $у$.5еёрго е, 
которая говорит интерпретатору, что теперь у нас есть профайлер. После 
этого интерпретатор на каждое событие будет вызывать функцию риой/ет. В 
Ру{оп таких событий не так уж и много: вызов функции (са), возврат из 
функции (тешит) и обработка исключения (ехсерйом). 


Функция-профайлер принимает три параметра: 


® /тате — представляет собой текущий стековый фрейм выполнения на- 
шей программы (5уз._ситггеп_#атез); 


® едет — строка, имя события; 


® 0755 — специальные аргументы, которые отличаются в зависимости от 
типа события. 


Классическим примером такого профайлера в Ру оп служит сРгоШе, ко- 
торый является частью стандартной библиотеки РуШоп и написан в виде 
С-расширения. В документации достаточно подробно написано о сРго/Ше, 
поэтому не будем повторяться: 


йНрз//аосзруфоп.отв/З/ПБтатиу/ртоШе.ти 


22.4. Ручное профилирование 


Не стоит забывать также и о возможности ручного профилирования кода. 
Если мы уже нашли узкое место в коде, можно использовать так называемое 
ручное профилирование — способ профилирования, при котором мы рука- 
ми вставляем код, измеряющий скорость работы. Все очень и очень просто 
— мы "засекаем" время до вызова функции, затем — после и таким нехитрым 
способом узнаем, сколько она выполнялась. Рассмотрим простой пример: 


Ру{Поп. Полное руководство 


1прогЕ &1пе 


{1 = Е1те.Е1те () 
Чо зомеев1па () 
{2 = Е1те. (Е 1пе 


рг1пё (62-61) 


Одной из часто встречающихся реализаций такого профилировщика мож- 
но считать такой декоратор: 


АеЕ ргой1ек (Еапс) : 
еЁ мгаррег (*агдчз, **кКмагаз): 
БеЕоге = Е1те.Е1те () 


геё\уа1 = Еоапс (*агдаз, **киагаз) 
аЁЕфег = Е1те.в1те (). 
тос.дероа ("Еопс®1оп '%5': %3", Еапс. паме__, аЁег-БеЕоге) 


тебигп мгаррег 


@рго! ег 
АеЁ Ве11о (папе) : 
рг1пё ('Не11о, %5$' % папе) 


Решение настолько простое и эффективное, что в него даже нечего доба- 
вить. Тем не менее, следует помнить, что такой "профайлер" будет снижать 
скорость работы программы, и использовать его в продакшене крайне не 
рекомендуется. 


Скорее всего, это самый простой способ измерить скорость выполнения 
какого-то фрагмента кода. Большой недостаток этого решения заключается 
в следующем: необходимо не просто модифицировать код — нужно писать 
его. А это означает, что с большой долей вероятности этот код будет нельзя 
переносить между проектами. Ведь такой код пишется не просто под нужды 
определенного проекта, а под нужды определенной функции или несколь- 
ких функций. 


Зато есть и преимущество: можно измерять только то, что нам надо, и тогда, 
когда это необходимо. Например, включать профилирование только но- 
чью, когда посетителей сайта мало и производительностью можно немного 
пожертвовать. Также можно включать такой "профайлер", если сработает 
какое-то условие ("пользователь нажал кнопку А"), и проверить скорость 
работы нужной функции. 


ГЛАВА 23. 


МНОГОЗАДАЧНОСТЬ 
В РУТНОМ 


Рупоп. Полное руководство о ао в, ру%Воп 


Многозадачность в Рушоп наиболее часто проявляется в виде параллель- 
НОЙ обработки и является одним из самых сложных вопросов в обла- 
СТИ программной инженерии. Данной теме можно посвятить целую книгу, 
да и не одну, поэтому в данной главе будут даны лишь’поверхностные сведе- 
ния, и, если вы заинтересуетесь, вы сможете продолжить изучение данной 
тематики в других источниках. 


23.1. Есть ли необходимость в 
многозадачности? 


Зачем нужна многозадачность и что это вообще такое? Начнем со второго 
вопроса, ответ на который может удивить тех разработчиков, которые счи- 
тают, что многозадачность и параллельная обработка — это одно и то же. 


Если попытаться вникнуть в теорию распределенных систем, то два собы- 
тия считаются параллельными, если ни одно из них не влияет на другое. 
Другими словами, мы можем сказать, что нечто выполняется одновремен- 
но, если его можно полностью или частично разложить на составные ча- 
сти, которые не зависят друг от друга. Такие части могут обрабатываться 
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независимо друг от друга и порядок их обработки не влияет на конечный 
результат. 


Если мы обрабатываем информацию таким образом, то речь идет действи- 
тельно о параллельной обработке. В качестве примера приведем програм- 
мы по загрузке файлов, где файл разбивается на части и каждая часть за- 
гружается отдельно - в отдельном потоке, затем все эти части соединяются 
воедино в один файл. В этом случае действительно несколько потоков вы- 
полняются одновременно настолько, насколько это возможно (например, 
если в системе есть 1 процессор с одним ядром, то о каком параллельном 
выполнении может идти речь, если в определенный момент времени может 
выполняться инструкции только одного "потока"). Каждый из потоков за- 
гружает свою часть файла, а затем все это соединяется вместе, и нет разни- 
цы, в каком порядке были загружены эти части - главное, что на выходе вы 
получите целый и неповрежденный в результате такой загрузки файл. 


По-настоящему выполнять задачи распределенным способом мы можем 
только при наличии многоядерных процессоров или вычислительных 
кластеров. В одно время (начало и первая половина 2000-х) кластеры были 
очень популярны для организации параллельных вычислений - тогда в 
кластер объединялось несколько машин, на которых выполнялось специ- 
альное ПО для параллельных вычислений. Сегодня, когда 8 ядерным (и бо- 
лее). процессором никого не удивишь, настоящую многозадачность можно 
реализовать не только на настольном компьютере, но и даже на смартфоне. 


Теперь разберемся, зачем нам многозадачность. Естественно, для повыше“ 
ния эффективности работы приложения — обработка информации будет 
происходить быстрее. При разработке программ мы привыкли к последо- 
вательности выполнения шагов. Большинство компьютерных программ 
используют синхронные алгоритмы, позволяющие выполнять по одному 
действию за один раз. Такой способ обработки данных не очень подходит 
для масштабных задач или кейсов. К многозадачному выполнению прихо- 
дят в следующих случаях: 


1. Когда масштаб задачи настолько велик, что единственный способ решить 
ее за приемлемое время - это распределение ее выполнения на несколь- 
ко блоков (потоков), которые могут обрабатывать задачу параллельно. 


2. Когда есть необходимость принимать новые данные, даже если обработ- 
ка старых еще не завершена. 


Первая группа задач обычно решается с ПОМОЩЬЮ МНОГОПОТочных И МНО- 
гопроцессорных моделей. Вторая группа задач далеко не всегда требует 
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параллелизма и часто ее решение зависит от тонкостей самой задачи. Эта 
группа задач охватывает и кейс, когда приложение должно обслуживать 
несколько клиентов (например, есть веб-сервер, который обслуживает не- 
сколько разных пользователей) независимо друг от друга, не нуждаясь в 
ожидании успешного обслуживания других клиентов. 


Обе эти группы не исключают друг друга. Часто нужно сохранить время 
отклика приложения и в то же время обрабатывать данные на одном про- 
цессоре. Поэтому, казалось бы, разные и конфликтующие подходы к парал- 
лельности можно использовать одновременно. Часто это сочетается в разра- 
ботке веб-серверов, где нужно задействовать асинхронные циклы событий 
или потоки в сочетании с несколькими процессами, чтобы применять все 
доступные ресурсы и обеспечивать низкие задержки при высокой нагрузке. 


23.2. Многопоточность 


Реализация многопоточности — довольно сложная штука. Однако есть раз- 
личные высокоуровневые классы и функции, облегчающие использование 
многопоточности в ваших приложений. Сразу нужно отметить, что реали- 
зация многопоточности в Руоп не такая удачная, как в С или ]ама. В этом 
разделе мы поговорим об ограничениях многопоточности в Руо,п, а также 
рассмотрим общие задачи, где многопоточность жизненно необходима. 


23.2.1. ВВЕДЕНИЕ В МНОГОПОТОЧНОСТЬ 


Первым делом нужно разобраться, что такое многопоточность. Разработ- 
чик приложения может разделить свою работу на потоки, работающие 
одновременно и использующие один и тот же контекст памяти. Если код 
не зависит от сторонних ресурсов, то многопоточность никак не позволит 
ускорить работу на одноядерном процессоре, а только лишь добавит лиш- 
ние затраты ресурсов на управление потоками. Другими словами, для реа- 
лизации многопоточности нужен как минимум двухядерный процессор, в 
противном случае многопоточность навредит производительности. 


На многоядерных или многопроцессорных машинах, где каждый поток мо- 
жет выполняться на отдельном ядре процессора, многопоточность позволя- 
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ет повысить производительность программы. В принципе, данная аксиома 
характерна для всех языков программирования, а не только Руфоп. 


Примечание. Раньше, скажем лет 20-25 назад, все было пре- 
дельно просто. Один процессор — одно ядро (речь идет о бюд- 
жетных пользовательских компьютера, а не о высокопроизво- 
дительных серверах). По-настоящему многозадачность можно 
было реализовать на так называемых ЗМР-машинах, где уста- 
навливалось как минимум два одинаковых процессора, которые 
подключались к общей памяти и периферийным устройства. В 
таких системах процессоры тесно связаны друг с другом посред- 
ством общей шины и имеют равный доступ ко всем ресурсам 
вычислительной системы, а также управляются одной копией 
операционной системы. Ранее МР использовалась в основном 
на серверах, высокопроизводительных графических станциях 
— в общем, везде, где нужно было задействовать мощные вы- 
числительные ресурсы. Для обычных "десктопных" целей ЗМР- 
машины не покупались -— дорого, да и необходимости особой в 
них не было. 


Итак, термином многопроцессорный обозначают компьютеры, имеющие не- 
сколько физически раздельных процессоров (например, серверные мате- 
ринские платы часто имеют 2 или 4 сокета для подключения нескольких 
чипов), но управляемые одним экземпляром операционной системы (ОС). 


Со временем технологии стали дешевле и стали появляться многоядерные 
процессоры. Многоядерным считается центральный процессор (СРО), со- 
держащий в одном корпусе два или более вычислительных ядра на одном 
процессоре. С появлением многоядерности появилась некоторая путаница, 
поскольку есть мультиядерные (англ. тшЯ-соте) и многоядерные (тапу- 
соте) процессоры. Термин мультиядерный обычно применяется к централь- 
ным процессорам, содержащим два и более ядра общего назначения, одна- 
ко иногда используется и для цифровых сигнальных процессоров (О$ЗР) 
и однокристальных систем (ЗоС, СнК). Под многоядерностью процессора 
понимают, что несколько ядер являются интегрированными на одну инте- 
гральную схему (изготовлены на одном кремниевом кристалле). Если же в 
один корпус были объединены несколько полупроводниковых кристаллов, 
то конструкцию называют многочиповый модуль (англ. тш-сёр тоаше, 
МОМ). 
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Понятие многоядерный (англ. тапу-соте) может использоваться для описа- 
ния многоядерных систем, имеющих высокое количество ядер, от десятков 


до сотен или более. Например, именно название "многоядерный" ("тапу- 
соге”) использовалось ие! для вычислителей бе] МТС. 


Еще большую путаницу внесла технология Нурег-ТЬгеад тя от Ге]. В ней 
одно физическое ядро процессора определяется операционной системой 
как два логических ядра. Взять, например, процессор ше] Соге 15-72001. В 
нем два ядра, но каждое из них разделено на два логических ядра — говорят 
— на 2 потока ({геа4$). Такая компоновка позволяет выполнять одновре- 
менно (якобы) четыре потока. Не будем вдаваться в технические особен- 
ности реализации этой технологии (об этом вы сможете прочитать в Сети), 
но скажем, что прибавка к производительности на процессорах с Нурег- 
Тргеад тя составила 30% по сравнению с процессором с таким же количе- 
ством ядер, но без НТ. | 


Но вернемся к обсуждению МНОГОПОТОЧНОСТИ. Поскольку у нас есть не- 
сколько потоков, которые используют один и тот же контекст, нужно за- 
щитить данные от неконтролируемого одновременного доступа. Если два 
потока изменяют одни и те же данные, это может породить ситуацию, когда 
малейшее изменение в одном из потоков самым неожиданным образом по- 
влияет на конечный результат. Представим, что у нас есть два потока, уве- 
личивающих значение общей переменной: 


соцпфег = зВагеЯ соцпфек 
зВагеЯ соипеег = соипфег + 1 


Представим, что у переменной зйатей_соитег есть начальное значение 0. 
Представим, что потоки обрабатываю один и тот же код параллельно, см. 
табл. 23.1. 


Таблица 23.1. Параллельная обработка кода потоками 
Поток 1 


соцпфег = зрагеЯ соипеег соцпЕег = зрагеЯ соупеег 
[соипеег 0] соипеег 0 


зрагеа_соппфег соипеег + 1 ЗВагеЯ соипеек соипеег + 1 
[зВагеЯ_сочпеег 0 + 1] [зрагеЯ_соппфег 0 + 1] 
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В зависимости от моментов выполнения и доступности контекста может 
получиться результат 1 или 2. Такая ситуация называется опасностью гон- 
ки или состоянием гонки, и часто является причиной серьезных проблем в 
работе программы. Если ничего не предпринимать, то результатам работы 
такой программы мы не можем доверять. 


С помощью механизмов блокировки мы можем защитить данные и про- 
граммировать потоки, поскольку с их помощью мы можем убедиться, что 
доступ к ресурсам дается безопасным образом. Однако, неосторожное ис- 
пользование блокировок также может создать проблемы. Самая большая 
проблема возникает тогда, когда из-за неправильной организации кода два 
потока блокируют один и тот же ресурс и пытаются выполнить блокиров- 
ку второго ресурса, который уже был заблокирован ранее. Тогда программа 
"зависнет". Чтобы такого не повторилось, нужно отслеживать повторное 
обращение, что частично решает проблему, поскольку ограничивает попыт- 
ки заблокировать ресурс дважды. 


Однако если потоки используются для изолированных задач (например, 
одна задача получает файл 1, а вторая — файл 2, или один поток загружает 
обновление программы, а второй — обрабатывает различные события при- 
ложения), то и использование может существенно увеличить скорость ра- 
боты программы. 


Многопоточность, как правило, поддерживается на уровне ядра системы. 
Если у машины один процессор с одним ядром, система использует технику 
квантования времени, когда центральный процессор переключается с од- 
ного потока на другой так быстро, что кажется, что потоки выполняются 
одновременно, хотя на самом деле это не так - в один момент времени вы- 
полняется какой-то один поток. В этом случае, разумеется, ни о каком при- 
росте производительности речи идти не может. 


Но все изменится, если в системе есть несколько процессоров или процес- 
сор с несколькими ядрами - тогда процессы и потоки перераспределяются 
между процессорами и программа выполняется быстрее. 


В Руфоп используется несколько потоков на уровне ядра и каждый из них 
может запустить любой из потоков уровня интерпретатора. В реализации 
СРу`оп есть ограничение, делающее потоки менее пригодными для ис- 
пользования в разных контекстах. Все потоки, которые обращаются к объ- 
ектам Руфоп, работают с одной глобальной блокировкой. Это делается 
потому, что большая часть структур интерпретатора и сторонний код С не- 
безопасны для потоков и нуждаются в защите. 


Данный механизм называется СП. (глобальная блокировка интерпретато- 
$" Соба[ Гщетргеег ГосЁ). Периодически в сообществе разработчиков под- 
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нимается тема об удалении СИ. из Руоп, но пока процесс не сдвинулся с 
мертвой точки, поэтому вам придется работать с тем, что есть. 


Разберемся, что такое многопоточность в Ру!фогп. Если в потоках есть толь- 
ко код Руфоп, использовать потоки для ускорения программы не очень 
правильно, поскольку СП. будет глобально сериализовать выполнение всех 
потоков. Но СТР работает лишь с кодом РуШФогп. На практике СТ. может 
быть убран в расширениях С, в которых не применяются функции РуШФоп. 
Другими словами, несколько потоков могут производить операции ввода/ 
вывода или выполнять код С сторонних расширений параллельно. 


23.2.2. КЕЙСЫ, ПОДХОДЯЩИЕ ДЛЯ 
ИСПОЛЬЗОВАНИЯ МНОГОПОТОЧНОСТИ 


Использовать многопоточность следует в следующих случаях: 
»® Когда необходимы адаптивные интерфейсы 

» Делегирование работы 

® Создание многопользовательских приложений 


Разберем все эти случаи подробно. 


АДАПТИВНЫЕ ИНТЕРФЕЙСЫ 


Представим, что вы пишете какую-то программу, которой нужно скопиро- 
вать файлы из одного места в другое, например, программу для резервного 
копирования файлов или же программу для резервного копирования базы 
данных. У вашей программы есть пользовательский интерфейс, и вы хо- 
тите, чтобы задача по копированию файлов/создания дампа базы данных 
отошла на второй план (выполнялась в фоне), а интерфейс программы по- 
казывал бы пользователю информацию о ходе выполнения задачи и давал 
бы возможность прекратить задачу (кнопка Отмена). 


Хороший интерфейс позволяет пользователям работать с несколькими за- 
дачами одновременно. Достичь этого невозможно без использования пото- 
КОВ. 
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ДЕЛЕГИРОВАНИЕ РАБОТЫ 


Когда работа приложения зависит от нескольких внешних ресурсов, пото- 
ки могут повысить производительность приложения. Например, у нас есть 
функция индексирования содержимого файлов в папке. Для этого наша 
программа использует какую-то внешнюю программу. 


Мы можем обрабатывать файлы последовательно, выполняя нужную 
программу, но мы также можем создать отдельный поток для каждого кон- 
вертера и отправлять задачи по потокам. Общее время выполнения будет 
примерно равно времени обработки самого медленного конвертера, но оно 
не будет равно сумме работы всех конвертеров, как в случае с последова- 
тельным выполнением. Другими словами, если нам нужно обработать фай- 
лы размером 1, 5, 10 и 20 Мб, а время обработки равно 1 Мб/с, то при по- 
следовательном выполнении мы выполним всю задачу за 36 секунд, а при 
параллельном (при условии наличия четырех ядер у процессора), наша 
программа обработает все файлы за примерно 20 секунд. 


Именно поэтому использование потоков значительно увеличивает произ- 
водительность приложения и сокращает общее время выполнения. 


Другой достаточно популярный кейс использования потоков — выполнение 
нескольких запросов к внешнему серверу. Например, вам нужно делать 
несколько АР][-запросов к какому-то веб-сервису. Если сервер находится 
далеко, последовательное выполнение запросов, может занять достаточно 
много времени - ведь вам нужно дождаться ответа от предыдущего запроса. 
При параллельном выполнении вы потратите гораздо меньше времени на 
получения ответов. 


При работе с Бир нужно помнить, что при выполнении запроса максималь- 
ное время тратиться на чтение из ТСР-сокета. Данная операция блокирует 
ИО, из-за этого Руфоп снимает СП. при выполнении С-функции 7еси(), 
что позволяет существенно улучшить производительность приложения. 


МНОГОПОЛЬЗОВАТЕЛЬСКИЕ ПРИЛОЖЕНИЯ 


Рассмотрим обратный пример -— мы разрабатываем приложение, не обра- 
щающееся к внешнему Бр-сервису, а которое само является веб-сервером. 
Веб-сервер должен принять запрос пользователя, поставить его в новый 
поток, а затем ожидать новых запросов. Отдельный поток на пользовате- 


Рупоп. Полное руководстто ООО =. ру+Поп 


ля существенно упрощает работу разработчика. Конечно, нужно помнить о 
блокировках, если это запрос на запись. С запросами на чтение все гораздо 
проще. 


23.3. Практика: создание 
многопоточного приложения 


23.3.1. МОДУЛЬ ТНВЕАО 


Запуск нескольких потоков аналогичен одновременному запуску несколь- 
ких разных программ, но со следующими преимуществами: 


» Несколько потоков в рамках процесса используют одно и то же про- 
странство данных с основным потоком и поэтому могут обмениваться 
информацией или взаимодействовать друг с другом более легко, чем 
если бы они были отдельными процессами. 


® Потоки иногда называют легковесными процессами, и они не требуют 
больших затрат памяти; они дешевле процессов. 


У потока есть начало, последовательность выполнения и завершение. У 
него есть указатель инструкции, который отслеживает, где в его контексте 
он выполняется в данный момент. Поток может быть легко прерван. Поток 
можно временно приостановить, пока работают другие потоки - это назы- 
вается уступкой (у1е4). 


Разберемся, как начать новый поток. Для этого нам нужно вызвать следую- 
щий метод, находящийся в модуле ёйгеа4: 


{пгеаа.зкаге пем ЕВгеаа ( Еопс®1оп, агдз[, Киагдз] ) 


Данный метод позволяет создать потоки, как в Глпих, так и в МЯр4о\. Вы- 
зов метода немедленно возвращается, запуская дочерний поток. В качестве 
кода потока будет использована функция, заданная первым аргументом. 
Остальные аргументы передаются вызываемой функции. Когда функция 
завершает работу, то завершает работу и поток. 
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Здесь ата; — это’набор аргументов, передаваемых функции. Если функции 
не нужно передавать аргументы, используйте пустой кортеж. Последний 
параметр - необязательный. Это словарь аргументов ключевых слов. 


Рассмотрим полноценный пример (лист. 23.1). 


Листинг 23.1. Запуск потока 
#1! /озЕ/Ь1п/руЕВоп 


1прогЕ {ргеаа 
1трогЕ Е1те 


# Функция для потока 
аеЕ рг1пЕ &1те( {ргеаЯМаме, а4е1ау): 
соипЕ = 0 
иЬ11е соцпё < 5: 
с1те.з1еер (ае1ау) 
соипЕ += 1 
рглпе "%5: %5" 5 ( ЕргеаЧМате, Е1те.се1те (Е1те.Е1ме()) ) 


# Создаем 2 потока 


фгу: 
{пгеаа.зеаге пем ©ЕВгеаЯ( рг1пе ©1те, ("Тигеаа-1", 2, ) ) 
{ргеаа.загЕ_ пем_ЕВгеаа( рг1пЕ &1те, ("Твгеаа-2", 4, ) ) 
ехсер*: 


рг1пЕ "Ошибка: не могу создать поток" 


имр11е 1: 
разз 


Код из листинга 23.1 породит следующий вывод: 


Тргеаа-1: Моп Ос 04 08:42:17 2021 
Тргеаа-1: Моп Осе 04 08:42:19 2021 
Тргеаа-2: Моп Осе 04 08:42:19 2021 
Тргеаа-1: Моп Осе 04 08:42:21 2021 
Тргеаа-2: Моп ОсЕ 04 08:42:23 2021 
Тргеаа-1: Моп Осе 04 08:42:23 2021 
Тргеаа-1: Моп Осё 04 08:42:25 2021 
Тргеаа-2: Моп ОсЕ 04 08:42:27 2021 
ТЬгеаа-2: Моп ОсЕ 04 08:42:31 2021 
Тргеаа-2: Моп Осе 04 08:42:35 2021 
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Примечание. Вывод будет у вас отличаться - в зависимости от 
даты выполнения и настроек локали. 


Хотя модуль Штеа4 очень эффективен для низкоуровневой обработки по- 
токов, он очень ограничен по сравнению с более новым модулем театр. 


23.3.2. МОДУЛЬ ТНАЕАОМС 


Более новый модуль йтеайте, впервые. появившийся в в Ру оп 2.4, обе- 
спечивает гораздо более мощную и высокоуровневую поддержку потоков, 
чем модуль Штеаа, рассмотренный в предыдущем разделе. 


Модуль ёйтеа4 та предоставляет все методы модуля {йтеа4 и некоторые до- 
полнительные методы: 


® Штеадтв.асноеСоипк) - возвращает количество активных объектов по- 
тока; 


® Итеадтв.ситетТитеаа() — возвращает количество объектов потока в 
элементе управления потоком вызывающего объекта; 


® Штеадтв.епитета() - возвращает список всех активных в данный мо- 
мент объектов потока. 


В дополнение к методам, в модуле театр есть класс 'ТЬгеа4, реализую- 


щий потоки. Класс ТЬгеаЯ предоставляет следующие методы: 


® 7п()- является точкой входа для потока; 

® 514П()- запускает поток, вызывая метод гип(); 

® ]01п([время]) - ожидает завершения потоков; 

® 15АНОе()- проверяет, выполняется ли еще поток; 
е ре Мате()- возвращает имя потока; 


® зеМате()- устанавливает имя потока. 


Рассмотрим, как можно создать поток, используя метод Ейтеа@тр. Для этого 
нам нужно сделать следующее: 
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1. Определить новый подкласс класса Тргеа4. 


2. Переопределить метод __ши(зе ,аг$]) _ для добавления дополни- 
тельных аргументов 


3. Переопределить метод гип(5е{,аг5з]) для реализации того, что должен 
сделать поток после запуска. 


Создав новый подкласс Тгеа4, вы можете создать его экземпляр, а затем 
запустить новый поток, вызвав збаге(), который, в свою очередь, вызывает 
метод тии(). Полный пример показан в лист. 23.2. 


Листинг 23.2. Пример создания потоков с использованием 
модуля {Игеад та 


#!/цзг/Ь1п/руЕПоп 


1трогЕ +Вгеаа1па 
1троге &1те 


ех1+ЕР1ад = 0 


с1аз$ путнгеаа (ЕВгеаа1па.ТВгеаа) : 

АеЕ 111% (зе1Е, +ПгеааТО, паме, соипеег): 
{ВгеаЯ1п9.Тпгеаа.__1п1%__ (з3е1Е) 
зе1Ё.+пгеаатр = +пгеаатр 
зе1ЁЕ.паме = папе 
зе1Ё.соипеег = соипеег 

аеЁЕ гип (зе1ЕЁ) : 
рг1пе "Запу ск" + зе1Ё.паме 
рг1пе Е 11ще (зе1Ё.патме, 5, зе1Ё.соппфег) 
рг1пЕ "Выход из " + зе1Ё.паме 


`аеЕ рг1пЕ $ 1те (&пгеаЯМаме, соипфег, ае1ау): 
У\р11е соипфег: 
1Е ех1%Е1ад: 
ЕВгеаЧМаме .ех1* () 
{1те.з1еер (ае1ау) 
рг1пе "$3: $5" % (ЕПгеаЧМате, Е1те.се1те (+1те.1те ())) 
соипфег.-= 1 


# Создание новых потоков 
{Ргеаа1 = пуТЬгеаа(1, "Тргеаа-1", 1) 
{Вгеаа2 = пуТЬгеаа(2, "Тргеаа-2", 2) 


© Запу скпотоков 


+Ргеаа1 .зфаг* () 
Ргеаа2 .з{аг* () 


рг1пЕ "Выход из главного потока" 


Вывод программы будет следующий: 


Запуск Тигеаа-1 

Запуск Тигеаа-2 

Выход из главного потока 

ТЬгеаа-1: Моп Ос 04 09:10:03 2021 
Тргеаа-1: Моп Осф 04 09:10:04 2021 
Тргеаа-2: Моп Осф 04 09:10:04 2021 
ТЬгеаа-1: Моп ОсЕ 04 09:10:05 2021 
Тргеаа-1: Моп Осф 04 09:10:06 2021 
Тргеаа-2: Моп Осф 04 09:10:06 2021 
ТЬьгеаа-1: Моп Ос 04 09:10:07 2021 
Выход из Тргеаа-1 

ТЬгеаа-2: Моп Осе 04 09:10:08 2021 
ТЬгеаа-2: Моп Осе 04 09:10:10 2021 
Тргеаа-2: Моп ОсЕ 04 09:10:12 2021 


Выход из Тргеаа-2 


23.3.3. СИНХРОНИЗАЦИЯ ПОТОКОВ 


Модуль #теайтя содержит простой в реализации механизм блокировки, 
позволяющий синхронизировать потоки. Новая блокировка создается пу- 
тем вызова метода ГосА(), который возвращает новую блокировку. 


Метод асаште(Мост=) нового объекта блокировки используется для при- 
нудительного выполнения потоков синхронно. Необязательный параметр 
ЫосЕтЕ позволяет вам контролировать, ожидает ли поток получения бло- 
кировки. 


Если Бюсаив равен 0, поток немедленно завершается со значением 0, если 
блокировка не может быть получена и 1, если блокировка была получена. 
Если БосЁтЕ равен 1, поток будет заблокирован в ожидании снятия блоки- 
ровки. 


Метод те[еазе() используется для снятия блокировки, когда она больше не 
нужна. В листинге 23.3 приведен пример работы с блокировками. 


@&} рутпоп А ее Глава 23. Многозадачность в Рупоп 


Листинг 23.3. Работаем с блокировками 
#!/чзг/Ь1п/руЕВоп 


1прогЕ &Вгеаа1п9 
1прогЕ &1те 


с1азз шуТргеаа (&ВгеаЧ1па.Тргеачд) : 

аеЕ __ 111 (зе1Е, ЕпгеаЯГО, паме, соппеег): 
{ВгеаЯ1п9.Твгеаа. 111% _ (5е1Е) 
зе1Ё.ЕпгеаатТр = ЕВгеаатр 
зе1Ё.паме = папе 
зе1Ё.соипеег = соопёег 

аеЁЕ гоп (зе1Е): 
рг1пё "Запуск " + зе1Ё.паме 
# Получаем блокировку для синхронизации потока 
{АгеааоскК.асай1кге () 
рг1пе &1те (зе1Ё.пате, зе1ЁЕ.соупеег, 3) 
# Снимаем блокировку для освобождения нового потока 
{РгеааЪосК.ге]1еазе () 


ЧеЁ рг1пЕ &1ме (&ВгеаЧМаме, 4е1ау, сочпеег): 
имВ11е соипеег: 
Е1ме.3з1еер (ае1ау) 
рг1пЕ "%5: %5" % (&ргеаЯМаме, &1те.се1ме (&1ме.Е1те())) 
соипеег -= 1 


{ВгеаЬоск = ЕВгеа41п9 .Тоск () 
ЕАгеаа$ = [] 


# Создаем новые потоки 
{Вгеаа1 = пуТЬгеаа (1, "Тьгеаа-1", 1) 
{пгеаа2 пуТргеаа (2, "Тргеаа-2", 2) 


# Запускаем новые потоки 
{Ргеаа1 .зкаг® () 
{Ргеаа2 .з+аг® () 


# Добавляем потоки в список потоков 
ЕВгеаа$ .аррепа (+Вгеаа1) 
ЕВгеаа$ .аррепа (+пгеаа2) 


# Ждем завершения всех потоков 
Еог ® 1п ЕВгеааз: 

Е. ол () 
рг1пе "Выход из главного потока" 


Вывод будет следующим: 
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Запуск ТЬгеаа-1 

Запуск ТЬгеаа-2 

Тргеаа-1: Моп Ос 04 09:11:28 2021 
Тргеаа-1: Моп Осе 04 09:11:29 2021 
Тргеаа-1: Моп Осе 04 09:11:30 2021 
Тргеаа-2: Моп Осе 04 09:11:32 2021 
Тргеаа-2: Моп ОсЕ 04 09:11:34 2021 
Тргеаа-2: Моп Осе 04 09:11:36 2021 
Выход из главного потока 


23.3.4. МНОГОПОТОЧНАЯ ПРИОРИТЕТНАЯ ОЧЕРЕДЬ 


Модуль Оцеце позволяет вам создавать новые объект очереди, позволяю- 


щий хранить определенное число элементов. Следующие методы иснользу- 
ются для управления очередью: 

® де[()- удаляет и возвращает элемент из очереди; 

е рШО- добавляет элемент в очередь; 


® 0512е()- возвращает количество элементов, которые в настоящее время 
находятся в очереди; 


» етрё/() - возвращает Гие, если очередь пуста; в противном случае — 
Еаве; 


® ЩО - возвращает Т’ие, если очередь заполнена; в противном случае — 
Еаве. 


Рассмотрим пример (лист. 23.4). 


Листинг 23.4. Работа с очередью 


#! /сзг/Б1п/ру оп 
1трогЕ Оцеце 
1трогЕ ЕПгеаа1п9 
1троге Е1те 


ех1ЕЕ1ача = 0 


с1аз$ муТАгеаа (+Вгеаа1па.Тргеаа): 
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АеЕ _ 111 (5е1Е, ЕРгеааТрО, папе, а): 
{ргеаЯ1п9.Тргеаа. __1п1&_, (5е1Е) 
зе1Ё.+ВгеаатТр = +вгеаатр 
зе1Ё.паше = папе 
зе1Ё.а = а 

аеЕ гоп (зе1Е): 

‘рг1пе "Запуск " + $5е1Ё.папе 
ргосез5 Чафа (5е1Ё.папе, зе1{.а) 
рг1пе "Выход из " + зе1Ё.паще 


АеЕЁ ргосез5_Чафа (%пгеаЯМаме, а): 
м511е поЕ ех1еЕ1ад: 
ачаецеГоск.асаяй1ге () 

1Е поё могкОцеце.етруу (): 
Чафа = а.де* () 
ааецеГоск .ге1еазе () 
рг1пе "%5 обрабатывает %$5" $ (+РгеаЯМаме, аа*а) 

е15е: 
ааепеГоск.ге1еазе () 

Е1ще .5з1еер (1) 


{ВгеааТ1$+ = ["ТЬгеаа-1", "Тргеая-2", "ТЬгеаа-3"] 

папе! 1$ = ["Марк", "Денис", "Евгения", "Валерия", "Андрей" ] 
ачаецеГоск = +ргеаЧ1па .Тоск () 

могкОцеце = Оцете. Очеице (10) 
Ергеааз = [1] 

Ергеаатр = 1 


# Сгеафе пем Ергеааз 
Еог Маше 1п ЕВгеаат15*: 
{ргеаа = пуТЬгеаа (&ВгеааТр, Маме, иогкКОцепе) 
Ергеаа.з{аг* () 
{Ргеаа$ .аррепа (+пгеаа) 
Ергеаатр += 1 


# Заполняем очередь элементами из списка имен папе! 1$ 
ааецеГоск .асаий1ге () 
Бог мог 1п памеь 15%: 
могКкОпеце.ри* (мога) 
ааецеГоск .ге1еазе () 


# Ждем пока освободится очередь 
мр11е поЁ могКОцеце.епреу () : 


разз 


# Уведомляем потоки, что настало время завершения 
ех1+Е1ад = 1 


# Ждем пока завершат работу все потоки 
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ог Е 1п {Бгеааз: 
Е. отп () 
рг1пе "Выход из основного потока" 


Вывод скрипта будет следующим: 


Запуск ТЬгеаа-1 

Запуск Тьгеаа-2 

Запуск ТЮгеаа-3 

Тргеаа-1 обрабатывает Марк 
ТЬгеаа-2 обрабатывает Денис 
ТЬгеаа-3 обрабатывает Евгения 
ТЬгеаа-1 обрабатывает Валерия 
ТЬгеаа-2 обрабатывает Андрей 
Выход из ТЮгеаа-3 

Выход из Тргеаа-1 

Выход из ТЬгеаа-2 

Выход из основного потока 


Как видно, три потока поочередно обрабатывают элементы из списка имен. 


23.4. Практический пример: 
многопотоковый сетевой сервер 


В этом разделе будет показано, как создать сетевое приложение, обслужи- 
вающее нескольких клиентов. Возможно, оно станет основой для вашего 
собственного проекта. Начнем с разработки сервера — программа, которая 
будет "слушать" сокет и принимать соединения от клиентов. Наш сервер 
будет слушать порт с номером 8888. Порты с номерами 80, 448, 8080, 8000, 
8081, 3128 использовать не рекомендуется, поскольку они могут быть за- 
няты веб-сервером или прокси-сервером. Чтобы сервер слушал порт, нам 
нужно выполнить два вызова: 


зекуег.Ь1па ( (ТОСАЬНОЗТ, РОВТ)) 
зекуек. 11зфеп (1) 


ее ру Глава 23. Многозадачность в Ру{оп 


Здесь ГОСАТНОЗТ - это имя локального компьютера (с адресом 127.0.0.1), 
а РОКТ - нужный нам порт. Метод 1и4() связывает наш сервер с опреде- 
ленным портом. А вот метод #5еп() запускает прослушку этого порта. 


Листинг 23.5. Классический сервер, обслуживающий одного 
клиента 


1трогЕ зоскее 
ТОСАЬНОЗТ = "127.0.0.1" 
РОВТ = 8888 
зегуег = зоскеф.зоскей (зоскее.АЕ ТМЕТ, зоскефе.5ОСК_5ТВЕАМ) 
зегуе!г`. Б1па ((ТОСАТЪНОЗТ, РОВТ)) 
зегуег.11зе еп (1) 
рг1п® ("Ждем запрос клиента...") 
мБ11е Ткие: 
с11еп СоппесЕ1оп, с11еп Ааагез$ = зегуег.ассере () 


рг1п* ("Подключился клиент :", с11епеАаагезз) 
Чафа = с11еп®Соппесе1оп.гесту (1024) 
рг1п ("Получено от клиента :" , Чава.аесоае ()) 


с11епСоппесе1оп .зепа (руез ("Не11о", 'ОТЕ-8')) 
с11епЕСоппесЕ1оп.с1озе () 


Наш сервер ожидает запрос клиента. Как только клиент подключится, сер- 
вер примет соединение (метод ассер(()), получит данные от клиента (метод 
теси()).и отправит ему в отчет строчку Нео (метод 5еп4()). 


Программа-клиент приведена в лист. 23.6. 


Листинг 23.6. Программа-клиент 


1трогЕ зоскее 

ЗЕВУЕВ = "127.0.0.1" 

РОКТ = 8888 

с11епЕ = зоскеф.зоскей (зоскее.АЕ_ТМЕТ, зоскее.5о0сСк 5ТВЕАМ) 
с11епе .соппесе ( (ЗЕВУЕВ, РОВТ)) 
с11епф.зеп4а11 (ъукез ("Не11о, зегуег!!!", 'ОТЕ-8')) 

Чака = с11епё.гесу (1024) 

рг1пе (Ча а.аесоае ()) 

с11епе.с1о$е () 


Клиент работает просто — он подключается к серверу и отправляет строчку 
Нео, зегуег!!!. Кодировка ОТЕ-8 (вы можете использовать кириллицу). 


Теперь усложним задачу — напишем многопотоковый сетевой сервер. Он 
будет запускать отдельный поток для обработки каждого нового клиента -— 
подобно тому, как работают " настоящие" серверы. Для реализации нашей 


Рупоп. Полное руководство ОО @ руфПоп 


программ мы будем использовать модули 50сЁеё и #теайте. Код програм- 
мы-сервера приведен в лист. 23.7. 


Листинг 23.7. Код многопотокового сервера 


1трог® зоскее, Ергеаа1па 
с1аз$ С11епеТЬгеаа (Ергеаа1пч.Тргеаа) : 
аеЁЕ __ 111 _ (3е1Е,с11еп*Адагез$, с11епЕзоскеф) : 
Ергеа91п9.Тьгеаа. ^ 101  (5е1Е) 
зе1Ё.сзоскее = с11епёзоскее 
рг1пЕ ("Новое соединение: ", с11епёАаагезз) 
аеЕ гип (зе1 Е): 
рг1пе ("Адрес клиента : ", с11епАдагезз) 
#3е1ЁЕ.сзоскКее. зепа (руфез ("Н1, ТЬ1$ 15$ Егом 
Зегуег..", 'цЕЕ-8!)) 
59 = '' 
мр11е Тгие: 
Чафа = зе1Ё.сзоскКее.гесу (2048) 
$9 = Чафа.4есоае () 
1Е пзд=='Ьуе' : 
Бгеак 
рг1пе ("от клиента ", пз9а) 
зе1Ё.сзоскКеЕ. зепа (Буеез (тза, 'ОТЕ-8')) 


рг1пе ("Клиент ", с11епЕАдагезз , " отключился...") 
ТОСАТНОЗТ = "127.0.0.1" 
РОВТ = 8888 


зегуег = зоскКеф.зоскеф (зоскее.АР_ТМЕТ, зосКеф.5ОСК_5ТВЕАМ) 
зегуег .зеезоскКор® (зоскее.50Т ЗОСКЕТ, зоскее.50_ВЕЧЗЕАООВ, 1) 
зегуег .р1па ( (ТОСАТНО$Т, РОВТ)) 
рг1п® ("Ждем запросы...") 
мр11е Тгие: 
зегуег.11з%еп (1) 
с11епёзосКк, с11епЕАдагезз = зегуег.ассер* () 
пеиЕргеаа = С11епТьгеаа (с11епАаагезз, с11епезоск) 
пеиЕргеаа.з*аг* () 


Сначала мы определяем объект СПепеТргеа4 класса (ргеадште.ТЬгеад. Мы 
переопределяем метод __шй__ - инициализация и вывод информации о 
клиенте. Затем мы переопределяем метод 7ии() - это и будет наш метод об- 
работки соединения с клиентом. Мы просто принимаем сообщения от кли- 
ента, пока не увидим сообщение фуе. Как только клиент передает там это 
сообщение, мы прерываем обработку клиента. 


Программу-клиент (лист. 23.8) также нужно немного переделать. Техни- 
чески она мало чем отличается от первой версии, просто добавлена реакция 
на ключевое слово буе. 
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Листинг 23.8. Новый клиент 


1трогЕ зоскее 
ЗЕВУЕК = "127.0.0.1" 
РОВКТ = 8888 
с11епЕ = зосКее. зосКе® (зоскефе.АР_ТМЕТ, зоскКее.бОСК_5ТВЕАМ) 
с11епЕ .соппесе ( (ЗЕВУЕВ, РОВТ)) 
с11епф.зепЯа11 (Буеез ("ТВ1$ 1$ Егом С11епе", 'ОТЕ-8')) 
\611е Тгие: 
1п_Чафа = с11епе.гесу (1024) 
рг1п® ("От сервера :" ‚1п_@Чафа.аесоае () ) 
оиЕ_Чафа = 1при* () 
с11еп*.5епда11 (руфе$ (опЕ_ Чака, 'ОТЕ-8')) 
1Е опЕ Чаба=='руе': 
Ьгеак 
с11епе.с1озе () 


Как запускать все это? Первым делом откройте командную строку (или 
терминал) и запустите сервер (руоп зегуег.ру), а затем откройте несколь- 
ко терминалов и запустите в каждом из них по клиенту (ру{Поп сНепё.ру). 
А затем наблюдайте за волшебством! Вы увидите, что наш сервер обрабаты- 
вает параллельно каждого клиента. 


"Издательство Наука и Техника" рекомендует: 


Васильев А. Н. 


Рупоп 


на примерах 


Вкл 
От простейших 
конструкции 
до петоты о списками мирование 
и кортежами на Рупоп 


3-е 
издание 


Практический курс 
по программированию мт 
=> 


РуПоп на примерах. Практический курс по программированию. 3-е изда- 
ние. — СПб.: Наука и Техника. — 432 с., ил. 


В этой книге решать будем две задачи, одна из которых приоритетная, а вторая, хотя 
и вспомогательная, но достаточно важная. Наша основная задача, конечно же, 
изучение синтаксиса языка программирования Рушоп. Параллельно мы будем осва- 
ивать программирование как таковое, явно или неявно принимая во внимание, что 
соответствующие алгоритмы предполагается реализовывать на языке Руоп. 


Большинство авторов книг в своих трудах рассматривают теоретические основы 
языка и уделяют основное внимание базовому синтаксису языка, не рассматривая 
при этом практическую сторону его применения. Эта же книга старается воспол- 
нить недостаток практического материала, содержит множество примеров с ком- 
ментариями, которые вы сможете использовать в качестве основы своих программ- 
ных решений, изучения РуФоп. 


Материал книги излагается последовательно и сопровождается большим коли- 
чеством наглядных примеров, разноплановых практических задач и детальным раз- 


бором их решений 
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Рутоп: Создаем программы и игры. 2-е издание. — СПб.: Наука и Техника. 
— 400 с., ил. 


Данная книга позволяет уже с первых шагов создавать свои программы на языке 
Руфоп. Акцент сделан на написании компьютерных игр и небольших приложений. 
Есть краткий вводный курс в основы языка, который поможет лучше ориентиро- 
ваться на практике. По ходу изложения даются все необходимые пояснения, при- 
водятся примеры, а все листинги (коды программ) сопровождаются подробными 
комментариями. 


Отличный выбор для всех, кто хочет быстро и эффективно научиться писать 
программы на РуШоп. 
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Издательство «Наука и Техника» 


КНИГИ ПО КОМПЬЮТЕРНЫМ ТЕХНОЛОГИЯМ, 
МЕДИЦИНЕ, РАДИОЭЛЕКТРОНИКЕ 


Уважаемые читатели! 


Книги издательства «Наука и Техника» вы можете: 
> заказать в нашем интернет-магазине БЕЗ ПРЕДОПЛАТЫ по ОПТОВЫМ ценам 


МИЛ. ПЕ. СОП.ГИ 
® более 3000 пунктов выдачи на территории РФ, доставка 3—5 дней 
® более 300 пунктов выдачи в Санкт-Петербурге и Москве, доставка — на следующий день 


Справки изаказ: 


® на сайте МИМУМ/. ПИ. СОГП.ГИ 
® по тел. (812) 412-70-26 
® по эл. почте пИтаЙ@пй.сот.ги 


> приобрести в магазине издательства по адресу: 


Санкт-Петербург, пр. Обуховской обороны, д.107 
М. Елизаровская, 200 м за ДК им. Крупской 
Ежедневно с 10.00 до 18.30 
Справки и заказ: тел. (812) 412-70-26 


> приобрести в Москве: 


«Новый книжный» Сеть магазинов тел. (495) 937-85-81, (499) 177-22-11 

ТД «БИБЛИО-ГЛОБУС» ул. Мясницкая, д. 6/3, стр. 1, ст. М «Лубянка» 
тел. (495) 781-19-00, 624-46-80 

Московский Дом Книги, ул. Новый Арбат, 8, ст. М «Арбатская», 

«ДК на Новом Арбате» тел. (495) 789-35-91 

Московский Дом Книги, Ленинский пр. д.40, ст. М «Ленинский пр.», 

«Дом технической книги» тел. (499) 137-60-19 

Московский Дом Книги, Комсомольский пр. д. 25, ст. М «Фрунзенская», 

«Дом медицинской книги» тел. (499) 245-39-27 

Дом книги «Молодая гвардия» ул. Б. Полянка, д. 28, стр. 1, ст. М «Полянка» 


тел. (499) 238-50-01 


> приобрести в Санкт-Петербурге: 


СанктПетербургский Дом Книги Невский пр. 28, тел. (812) 448-23-57 
Буквоед. Сеть магазинов тел. (812) 601-0-601 
> приобрести в регионах России: 

г. Воронеж, «Амиталь» Сеть магазинов тел. (473) 224-24-90 
г. Екатеринбург, «Дом книги» Сеть магазинов тел. (343) 289-40-45 
г. Нижний Новгород, «Дом книги» Сеть магазинов тел. (831) 246-22-92 
г.Владивосток, «Дом книги» Сеть магазинов тел. (423) 263-10-54 
г. Иркутск, «Продалить» Сеть магазинов тел. (395) 298-88-82 
г. Омск, «Техническая книга» ул. Пушкина, д.101 тел. (381) 230-13-64 


Мы рады сотрудничеству с Вами! 


Кольцов Дмитрий Михайлович 
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Кольцов Д. М. 


Эта книга поможет вам освоить язык программирования Ру{Поп практически 
с нуля, поэтапно, от простого к сложному. Первая часть книги посвящена 
базовым основам языка: переменные и типы данных, операторы, циклы и 
условные операторы, математические функции, кортежи, множества и 
словари, итераторы и генераторы, модули и пакеты, а также многое другое. 
Во второй части книги перейдем к более сложным вещам в Ру®оп: 
объектно-ориентированное программирование, метапрограммирование, 
многопоточность и масштабирование. 


Отдельное внимание будет уделено документированию своего проекта в 
Руфоп, контролю и оптимизации кода. Теоретическая часть книги 
сопровождается практическими примерами, позволяющими на практике 
осваивать полученные теоретические знания. 


Книга будет полезна как начинающим, так и тем, кто хочет улучшить свои 
навыки программирования на РУПоп. 


5 5-94387-270-9 “Издательство Наука и Техника" 


г. Санкт-Петербург 
Для заказа книг: 
(812) 412-70-26 НиГ 
е-тай: питай@пи.сот.ги се 
1 


МАМАМ. ПИ. СО. ГИ , 
9 78- 5-94387- 270-9 МИММ/. ПИ. СОГТ.ГИ 


